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WELCOME I 


WELCOME 

to The MagPi 89 



Lucy 

Hattersley 


R aspberry Pi is unlike any other computer. On the one hand, it s 
a fully powerful desktop computer, at a fraction of the regular 
cost. At the same time, thanks to its educational roots, Raspberry 
Pi is ready to become just about anything. Everything from solar- 
powered boats (page 8) to cheese-grilling machines (page 16) can be 
found inside this magazine. 

Maybe you’ve got an idea for something to make. In which case 
our 50 Tips & Tools for Raspberry Pi feature (page 26) will help you 
kit out for 2020. This year could be your chance to finally build your 
crazy contraption. 

If, like me, you’ve no idea what to make next, then take a look at our 
Raspberry Pi 4 accessories guide (page 68). Here you’ll find kits and 
gadgets that can inspire you to build a friendly project. 

I believe 2020 is going to be an incredible year for technology and 
making, and The MagPi sits at 
the heart of the most creative 
community on earth. This magazine 
is packed with incredible ideas and 
builds engineered by some of the 
most fun people we know. 

Here’s to another decade 
of making. 

Lucy Hattersley Editor 


L vault OfFI CI*L RASPeeRBV 


Lucy is editor of 
The MagPi and cat 
whisperer. This 
month she's dressing 
up as a pantomime 
horse and running 
around Greenwich. 
As you do. 

magpi.cc 
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A A kestrel captured at night-time using 
Raspberry Pi NoIR infrared camera 


I The Nest Box 

live-streams garden birds 

This Springwatch-inspired nest box is used to lure Facebook 
users, such as Rosie Hattersley, away from cute cat videos 



A A PIR sensor and 
camera fitted to a 
kestrel box 

► The CAD design for 
the plastic tray at the 
top of a bird-box 


I t’s a tried and tested social media formula: 
cute animals doing adorably cute things - or 
just being cuddly and wholesome. Click 
‘like’ and share the heart-melting gorgeousness 
of the latest viral video. No wonder The MagPi 
magazine reader Jamie Wainwright's live stream 
of chicks in a nesting box caught our attention 
when we asked you about Raspberry Pi projects. 



Liverpool-based Jamie introduces viewers to 
the cute residents of The Nest Box using 
impressively high-quality images and video from 
three Raspberry Pi-enabled British bird-boxes, 
with three more being set up. 

These train video cameras on a kestrel box and 
also a barn owl box after Jamie proposed the 
camera feed to the Wirral Barn Owl Trust. 

Instant replay 

Throughout spring, all the cameras stream live to 
The Nest Box's 5500 Facebook wildlife fans 
(magpi.cc/nestbox). Out of season, visitors can 
enjoy a short movie recapping events from the 
nests earlier in 2019: magpi.cc/nestboxmovie. 

Jamie says one of the beauties of The Nest Box 
setup is that it requires so little equipment: a 
Raspberry Pi and Camera Module, along with a 
Raspberry Pi PoE HAT (magpi.cc/poe) to provide 
both power and internet connectivity, so there's 
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only one cable connection to weather-proof. A 
custom HAT controls LED lights and the 
Raspberry Pi Camera Module, providing high- 
quality images day and night. Python code 
records visitors to the nest boxes. This causes the 
Facebook feed to go into live streaming mode 
whenever there’s any nest box action. 

Creature comforts 

Thanks to some successful crowdfunding, Jamie 
was able to add sound via USB microphones 
attached to the Raspberry Pi rig. Furthermore, a 
schematic on The Nest Box’s GoFundMe page 
(magpi.cc/nestboxfund) shows the smart 
bird-box’s electronics hidden away in a small 
plastic box, with a fan to help keep everything 
cool during operation. E 3 


□ Facebook goes into live streaming mode 
whenever there's any nest box action □ 



A Each installation has 
a different design 
depending on the 
bird being monitored 
- this one is for the 
barn owl box 

M A 3D-printed section 
for the barn owl box 
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Aquatic Mini 

Observation System 

What computer da you use when you want to have a solar-powered, autonomous boat 
that measures water quality? Rob Zwetsloot discovers that the answer is Raspberry Pi 



Murray 

Lowery- 

Simpson 


Although coming 
from an engineering 
background, 

Murray has been 
developing 
software for a Little 
over 20 years. 

innaturerobotics.com 


T here are many basic rules when it comes to 
electronics. One of them is that water and 
electronics don’t mix, even if your average 
smartphone is able to take a brief dunk in the sink 
these days. So when someone comes to us talking 
about a waterborne project, we listen - and that’s 
exactly what happened when Murray Lowery-Simpson 
emailed us about his solar-powered boat. 

a My project is named AMOS (Aquatic Mini 
Observation System),” Murray tells us. “It is a solar- 
powered, autonomous airboat for measuring water 
quality over large, distributed areas.” 

Murray has worked on a couple of prototypes for 
the boat. The first one was made out of a kayak beer 
cooler (a small kayak that acts as a beer cooler) and 
had propellers that would end up getting gunked up. 
He also tested distance measuring with a Raspberry Pi 
Compute Module’s stereo vision before settling on a 
lidar module and a Raspberry Pi 3B+. 


“During this past winter, I built a second 
prototype, this time using a longer surfboard- 
type design constructed from glued-together 
insulation foam that was given a coat of fibreglass 
to give it some added strength and stiffness,” 
Murray explains. “Instead of the water propellers, 
a single 10-inch drone propeller and motor were 
used and connected to a small waterproof servo 
motor at the stern end of the boat. This design was 
lighter (about 13 kg) and longer, and although the 
air propeller only produced about a tenth of the 
thrust provided by the dual water propellers, the 
improved draft and hydrodynamic shape made it 
slightly faster in the water. ” 

A Raspberry Pi controls the speed and angle of 
the air propeller, takes sensor readings from the 
water, interacts with the lidar module, and has 
several other functions so that it knows its speed 
and heading. 


► AMOS will be usefuL 
to researchers, and a 
good base 
for hobbyists 
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> Murray got into 
robotics in Late 2017 


> He was inspired by 
Local news about 
pollution on 
public beaches 


> AMOS tests pH, 
salinity, dissolved 
oxygen, turbidity, 
and more 


> Pictures from the 
Camera Module 
are mostly used to 
locate a Lost AMOS 


> AMOS can 
be controlled 
by iOS and 
Android devices 


The boat is fully 
automated and, on 
a sunny day, fully 
self-sufficient 


Quick FACTS 


A suite of sensors check the 



4 The old version was 
a bit slower and 
stubbier, and the fans 
wouLd get weeds 
stuck in them 
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“I’m hoping that AMOS will be used for water 
testing by environmental services companies, and 
industrial customers such as mine operators that 
may be required by law to confirm that pollution 
limits in bodies of water surrounding their 
operations are not exceeded/ 5 Murray reveals. “I’m 
hoping also to be able to offer it at an attractive 
price point, with modular components so that 
researchers or robotic boat enthusiasts could also 
use it, or some subset of it, in their own projects. 55 

□ Approximately 150 km of testing has been 
completed on the second AMOS prototype □ 

Major tests 

The prototypes aren’t just proofs of concept, 
either: they’re fully functioning test beds, as 
Murray explains: “Approximately 150 km of testing 
has been completed on the second AMOS prototype 
in 2019. It can work well in shallow water (as little 
as 2 cm depth) and can travel through regions of 
water with lots of grass or other vegetation without 
any worries about getting stuck. Its airboat design 
works best under conditions of low wind (less than 
20 km/h) and it can travel at a top speed of about 
2.7 knots (5 km/h). Provided the sun is shining on 
a clear day and higher than about 40 degrees in the 
sky, AMOS can run at top speed without depleting 
the charge of its battery.” 

Murray plans for AMOS to be on sale in the 
summer, so you don’t have too long to wait. ED 

Our interview with Murray covered many more topics 
we couldn't squeeze into the magazine , so please look 
out for the full transcript at magpi.cc/amos. 


▲ This photo gives you 
an idea of the size of 
the boat 
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H AMOS also works 
in cold weather, 
aLthough a Lack of sun 
means it can't operate 
for Long 


4 The surfboard body 
makes it Light and its 
Length aLLows for a 
Large soLar paneL 


^ We think the AMOS 
Looks quite majestic 
as it pootLes about 



A boat needs to be Launched. You can control 
the destination using a smartphone; there are 
apps for Android and iOS that you can find on the 
GitHub page: magpi.cc/amosGH. 


Testing the waters 



Using a combination of GPS, Lidar, and 
cameras, the boat navigates its way around 
waterways and rivers. This aLLows it to obtain a 
big sample from any given area, and see how it 
changes throughout. 


On a sunny day, it can happily take readings all 
day without too much interference. On a cloudy 
day, it may only operate for up to an hour. Although a 
bigger battery might solve this, it will be heavier. 
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Organnery 

pipe organ 

A French company is marrying broken electronic pipe 
organs with a Raspberry Pi, and finding it's a match 
made in heaven, as David Crookes discovers 



Daniel 

James 


DanieLJames is 
the director of 
64 Studio Ltd, 
which produces, 
integrates, and 
documents free 
and open-source 
software for media. 

organnery.com 


W hen it comes to the work of Audiotronic 
founder Raphael Mouneyres, silence is 
most certainly not golden. Given his job 
entails the repair of electronic pipe organs, a lack 
of sound points to a major problem - one that’s 
happening more often and becoming trickier to 
resolve using original parts. 

Raphael tell us that he increasingly found 
components for first-generation digital pipe 
organs - many of which are installed in churches 
across the world - to be either obsolete, expensive, 
or simply unobtainable, threatening to consign 
many an instrument to the scrap-heap. 

The solution has been to strip the organs of their 
old electronics and replace them with something 
new. “After some thoughts and calculations, we 
came up with a method that would retain the 
console, keyboard, and controls and instead make 
use of a small, affordable, and efficient single¬ 
board computer,” he says. 



▲ The AeoLus software allows a collection of stops to be saved to a 
USB memory stick for each organist 



▲ Digital organs have been used in place of pipe organs 
within churches for a while, but damp and the scarcity 
of spare parts mean they're not lasting as long 


The chosen device was a Raspberry Pi, selected 
because of its worldwide availability, strong 
development community, and affordable price. It 
offered a perfect way of bringing pipe organs back 
to life so that they can be played as before, while 
allowing modern options such as a touchscreen. 

“There are lots of good HATs available covering 
sound output, MIDI, and control interfaces,” says 
Daniel James, boss of 64 Studio, the company 
tasked with creating the software. 

Fine tuning 

As such, Daniel and colleague Chris Obbard began 
to work on a customised Debian GNU/Linux image 
called Organnery that made use of the open-source 
classical organ modelling software Aeolus and 
Raspberry Pi’s capabilities. With eleven different 
temperaments, variable tuning, three or more 
manuals, and a pedal board, as well as MIDI in/out 
control and the flexibility to play different sounds, 
a personalised experience is possible. 

“Organnery needed to be set up as a single-use 
appliance, and the requirements came directly from 
the organists we’ve been working with to refine 
the system,” Daniel says. “We made adjustments 
to the Aeolus source code as well as to supporting 
programs. These included Mididings, a scriptable 
MIDI router and processor written in Python. ” 
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Humid and 
cold churches 
mean organ 
electronics suffer 


PROJECT SHOWCA! 


Normally, a Raspberry 
Pi is fitted inside the 
electronic organ but this 
is an earlier prototype of 
the Organnery project 


If the organ has a MIDI output, it can be 
transformed into an Organnery with a 
plug-and-play expander, otherwise a 
technician will need to specially retro-fit it 


A touchscreen display can be used 
to control the Aeolus software - one 
organ console can accommodate 
different styles of sound 


Daniel also created minimal system images 
based on Debian Buster using Dibby, which is 
a collection of scripts that leverage the distro’s 
packaging tools. “This approach was a far leaner 
and more reproducible way to build appliances 
than starting from a standard image and stripping 
the system down/’ Daniel says. 

Retro hits 

So what’s the verdict? “Organnery offers a major 
sound upgrade since the sound produced by the 
Aeolus software is of a much better quality than 
digital electronics from the 1980s/’ Raphael says. 
“It gives the organ player access to new ‘pipes’ 
and complete control over sound placement in 
space, from a standard stereo system up to 3D 
Ambisonic diffusion.” 

Most Organnery systems are being retro-fitted 
into existing organs, but the system can be built 
from scratch using standard and affordable MIDI 
hardware. “Some of the smaller organs made for 
the domestic market have a five-pin MIDI Out 
socket and can be obtained for next to nothing,” 
Daniel explains. “Aeolus and Organnery can also 



▲ The MIDI switches of an organ are being retro-fitted with new 
eLectronics. powered by Raspberry Pi 


make learning the classical organ much more 
accessible than it has been in the past. ” 

Even so, bringing organs back to life, complete 
with the original woodwork and physical controls, 
is perhaps most satisfying. “Church organ consoles 
are also often made of expensive hardwoods so 
we are saving trees,” Daniel says. For organists 
used to the age-old interface of their instruments, 
that’s sure to be extra music to their ears. ED 


> Retro-fitting a 
Raspberry Pi 
revitalises 
broken organs 

> Organnery can be 

a MIDI expander for 
new sounds too 

> It runs Aeolus, 
allowing hundreds 
of potential controls 

> A touchscreen can 
also be fitted 


Organnery pipe organ 
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Airdrum 

This drumset can be played with a hover of your hands 
and gives visual feedback too, as David Crookes learns 



Alessandro 
Verdiesen and 
Luuk van Kuijk 


Alessandro is an 
electronics engineer 
with a passion for 
drones and speaker 
systems, while 
Luuk is studying 
for his master's 
degree in next level 
engineering. 

magpi.cc/airdrum 


► A Lot of meticulous 
planning has gone 
into the creation of 
the Airdrum over the 
past few years 


W e’re always going to beat the drum for 
projects that seek to improve the lives 
of people with severe disabilities. To 

that end, we fell in love with the Airdrum, which 
was created to allow anyone - in particular those 
with a mental or physical condition - to play a 
traditional instrument. 

Designed by two Dutch electrical engineering 
students, Alessandro Verdiesen and Luuk van 
Kuijk, the project came to life during their first 
year at university. “We aimed to develop a musical 
instrument that could be used to generate music 
by moving,” explains Alessandro, who has recently 
been working on a fully modular version 2.0. 

After speaking with therapists and health care 
institutions, the pair decided to make a drum that 
could be played by moving objects above a set of 
panels and they put a Raspberry Pi at its heart. 

“The basic functionality of the Airdrum is to detect 
the distance of an object above each connected 
panel and play a sound,” says Alessandro. “These 
panels contain IR distance sensors and coloured 
LEDs for visual feedback. ” 

Sorting the bass-ics 

From the outset, Alessandro and Luuk needed their 
project to be accessible, affordable, adjustable 
and, in the latest iteration, modular, with each 
drummable section containing an Arduino Mini, 
an IR sensor, and LEDs. They also wanted the 




A Custom-made Airdrum detecting modules fit snugLy into their 
3D-printed cases and can be arranged in a fuLL circle if you have 
enough of them 

instrument to have a broader appeal and be 
suitable for everybody, including professional 
musicians, so it had to sound as good as it played. 

“We needed it to be as versatile as it can be and 
allow people to choose custom sounds, colours, 
and lights while being a standalone instrument and 
a multi-purpose input/output device,” Alessandro 
reveals. To make it easy to place the modules 
together, they used magnetic connections between 
the panels. This allowed them to be placed together 
in various configurations, with a minimum of two 
per Airdrum. 

With a structured plan that divided milestones 
into electrical, mechanical, and software 
components, the pair used 3D printing for the 
enclosure, which enabled rapid prototyping for 
quick interactions. They used speaker panels to 
bookend the modules for auditive feedback. 

Panel beating 

Each of the panels includes a buck converter 
so that the current through the connectors can 
be drawn to a minimum. The master module 
panel contains a Raspberry Pi 3 running custom- 
made programs written in C and Python, as well 
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□ It also has a l 2 C bus to 
act as a data transfer 
master unit □ 

as the free open-source software synthesiser 
FluidSynth. It connects to the other panels 
through I 2 C, constantly polling the panels for 
their measurements and for the configuration of 
their colour. 

“If an object has been detected, the Raspberry 
Pi generates a sound and outputs it on the AUX 
audio jack,” says Alessandro. “This output is then 
used by the mono D-class amplifiers in the speaker 
panels to make the tones audible.” 

The pair chose a Raspberry Pi because of its 
versatility and technical prowess. “The Airdrum 
needed something powerful enough to run 
software to generate audio through MIDI using 
the input from the panels and the Raspberry Pi 
is a great universal and low-cost development 
board with integrated DAC for audio,” explains 
Alessandro. “It also has a PC bus to act as a data 
transfer master unit and they’re compact enough 



to fit inside of the casing. The Raspberry Pi enables 
easy implementation of future upgrades, too.” 

Indeed, the pair want to explore the MIDI 
possibilities and connect the Airdrum with a 
smartphone or tablet. An app is being planned, 
as is a built-in synthesiser. “The people we 
have shown the Airdrum to have been very 
enthusiastic,” Alessandro says. “That has been 
very motivating.” ED 


A These speaker modules 
can bookend the sensor 
panels, although the 
sound can be outputted 
via the Raspberry Pi 
to a different sound 
system too 


Quick FACTS 


> Disabled people 
can play without 
holding it 

> A new modular 
design makes 
it versatile 

> It can play MIDI files 
via a Raspberry Pi 

> The designers also 
want pro musicians 
to enjoy it 

> A basic two-module 
Airdrum would cost 
about £120 
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Cheeseborg 


In wintertime, what could be more comforting than a grilled cheese sandwich? 


Cheeseborg uses Raspberry Pi to serve them up, as Rosie 



Taylor 

Tabb 


TayLor studied 
mechanical 
engineering at 
Carnegie Mellon 
University, exploring 
how people interact 
with hardware, and 
thinks Raspberry Pi 
is the ideal platform 
for this. He now 
works for creative 
agency DeepLocal, 
making ‘wild and 
whimsical' robots. 

tabb.me 


M aking a splash with your final-year 

university project can be the ideal way to 
gain the attention of potential employers 
and land yourself your dream job. Appealing to your 
lecturers’ and classmates’ stomachs is also a pretty 
effective way of getting them onside. Hearing from 
Taylor Tabb about the robot project he and friends 
Mitchell Riek and Evan Hill cooked up for their 
mechanical engineering degree, it’s little surprise 
to learn that having graduated in the summer of 
2019, he’s already embarked on a fantastic-sounding 
Raspberry Pi-focused career. 

“Cheeseborg was born out of our need to concept, 
design, and build a final prototype of a project in our 
senior engineering design class,” says Taylor. “As 
hungry college students awake at hours that it’s often 
hard to find food, we knew this was our calling - not 
just for us, but for grilled cheese eaters everywhere.” 

Cheeseborg is a dedicated, hands-free grilled 
cheese making robot that will satisfy cheese cravings 
at all hours. The Google Assistant SDK and AIY Voice 
Kit provide voice activation. Both “work fantastically 
with Raspberry Pi 3 Model B+,” says Taylor. Their 




Cheeseborg requires you 
to say please when you 
ask for a grilled cheese! 




Warning! 

Hot mess! 


Gooey butter is messy 
stuff. Be prepared for 
your kitchen, as well 
as your griLLed cheese 
sandwich, to be buttered 
aLlover! 
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> Taylor thinks 
there’s a whole 


world of culinary 
robots to come 


HEESEB&RG 

GENUINE MELT-O-MATIC 


oogle, make me 
d cheese please! 




> Taylor now works 
with Raspberry Pi 
almost daily 

> His business card 
says he’s ’sweeter 
than Raspberry Pi!' 


A vacuum picks up 
the slice of toast to be 
‘buttered’ before toasting 


People usually love Cheeseborg s 
hyper-mechanical motions paired 
with the whimsy of grilled cheese 


> His first Raspberry 
Pi project was a 
‘not great’ radio 
telescope 


Cheeseborg’s acrylic 
body is hidden in a laser- 
etched wood enclosure 


Raspbian and Raspberry Pi allowed 
Cheeseborg’s makers to explore 
dozens of versions of its interface 




> He recently made 
a not-so-edible 
bubble maker: 

magpi.cc/ 

loTBubbleMaker 



▲ The Cheeseborg even 
features a mini chute for 
delivering the sandwich 


4 We do Love a griLLed cheese 
sandwich and this one looks 
pretty tasty 


Cheeseborg magpi.cc 
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Cheeseborg'Degrrtg 
to take shape in the 
‘ -Carnegie Mellon 
University makerspace 


□ A dedicated, hands-free grilled cheese 
making robot that will satisfy cheese 
cravings at all hours □ 

customised build of Google Assistant, sourced from 
the AIY Kit and Google Cloud SDK, allowed them 
to add some personality: you can ask about the 
weather while awaiting your sandwich. 

Raspberry Pi also triggers its assembly, while 
motor control circuits and motion are operated by 
Arduino Mega. Taylor reveals, “We wrote our own 
code, but also used open-source Arduino libraries,” 
dictating timings and the motions for each step. 

Carnegie Mellon’s Department of Mechanical 
Engineering’s makerspace provided hardware 
commonly used in 3D printer kits, such as stepper 
motors and linear motion carriages. However, 


the acrylic parts were designed and laser-cut 
by Mitchell, Evan, and Taylor. Impressively, 
the project cost just $200 to build, and took 
approximately eight weeks to complete. 

Taste test 

The team undertook three weeks of customer 
research to identify grilled cheese preferences. 
“There was a lot of going back and forth between 
our build, CAD software, and laser cutter, adjusting 
parts as we learned more about the mechanics of 
bread and cheese,” recalls Taylor. They spent days 
just tuning the grilling time to get the gooeyness 
and crispiness just right, while experiments in 
applying the butter resulted in a thoroughly dairy- 
spattered makerspace. 

Eventually, they went with a spray ‘butter’. 

“We aimed at the cooking plates and activated 
just before the bread was moved to be cooked, 
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▲ Cheeseborg's makers 

earned even more goodwill 
from their classmates when 
they brought it along to 
their design expo 


4 Taylor, Mitchell, and Evan at 
5 am, just after Cheeseborg 
was finally finished 


Making your own 
grilled cheese robot 



This is the ideal project with which to use 
Google Assistant in Google’s Raspberry Pi 
AIY Voice Kit, and the Google Cloud SDK for voice 
activation. Experiment with phrases to initiate the 
snack-assembly process. 



Raspberry Pi now hands over to Arduino. 
Use Arduino Mega to control the robot that 
assembles the grilled cheese sandwich once 
Raspberry Pi instructs it. Open-source Arduino 
libraries are invaluable here. 


thus buttering both sides [not to say the rest of 
Cheeseborg]. In the end, we found if we just spray 
the grill plates every five [sandwiches] or so, it still 
is enough to make a crispy, gooey grilled cheese! 

“As with all good projects, we had no idea if it 
was going to work until 4am the morning before it 
was due, when Cheeseborg popped out its first fully 
hands-free grilled cheese sandwich.” 

Making your own grilled cheese robot 

Interest levels online have been such that Taylor 
and his colleagues may consider offering a kit 
version. While he cautions that there’s a huge 
amount of fine-tuning involved, he says, “If 
anyone out there is building a grilled cheese robot, 
we’re more than happy to offer any insights.” 
Contact him at tabb.me/grilledcheese. EJ 



Use tongs or suction to pick up slices of bread 
and add a chute for the snack's delivery. 
However, positioning bread to be buttered and 
adding cheese takes patience. 
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CutiePi 

Want to liberate your projects from the desktop? This 
all-in-one Raspberry Pi tablet may provide the answer, 
Phil King investigates 



Penk 

Chan 


A digital nomad 
wannabe from 
Taiwan, currently 
living in Tokyo 
and working as a 
principal software 
engineer at The 
Qt Company. He's 
Leading a team 
of open-source 
enthusiasts to 
make the CutiePi 
tablet happen. 

cutiepi.io 


H aving long dreamt of owning a usable 

Linux-based portable device, a group of 
enthusiasts set out to create one and the 
CutiePi tablet was born. Based around a Raspberry 
Pi Compute Module 3+ Lite and custom carrier 
board, it features an 8-inch touchscreen, typical 
tablet features, and everything you need to make 
your Raspberry Pi projects portable. 

“We tried to make the CutiePi tablet on par with 
normal tablets,” says project lead Penk Chan. 
“You’ll find a gyro, a microcontroller for battery 
and button monitoring, WiFi/Bluetooth, and a 
speaker. We also kept the camera connector and 
made the remaining GPIO pins available, keeping it 
hacking friendly.” This will enable it to be used as a 
launchpad for users’ portable Raspberry Pi projects. 

Making a portable device isn’t easy, though. “It’s 
not just about the Li-Po battery nor the DC-DC 
step-up converter,” says Penk. “Those features 
that we take for granted in consumer electronics, 
like using the device while it’s charging, reading 
remaining battery level, or simply detecting a 
power cable plug-in, are very hard to get right with 
modules and kits, let alone having a user interface 
that works. To top it all off, you need a case that 
houses all the hardware parts and cables.” 



their own custom-designed carrier board. “Using 
the Compute Module allowed us to make the device 
a lot thinner, explore other form factors other than 
the regular Raspberry Pi 3’s, and probably most 
important of all, it allowed us to mass-produce the 
CutiePi tablet,” explains Penk. 

Taking around three months to develop, the 
CutiePi carrier board is based on the reference 
designs made freely available by Raspberry Pi, and 
the team have open-sourced their now OSHWA- 
certified hardware: magpi.cc/CutiePiBoard. “At 
the heart of this project is our love for open- 
source, and CutiePi is our expression of that 
affection,” says Penk. “All designs are available 
under open-source licence, and anyone who 
wants to produce it, or even build on it to make 
their next portable project, can freely do so. In 
fact, we advocate it.” 


□ Anyone who wants to produce it, or even build on it to 
make their next portable project, can freely do so □ 


Custom carrier 

The first CutiePi prototype was a cardboard box 
which housed an off-the-shelf HDMI display, a 
Raspberry Pi 3, and a power bank. For the second 
one, they stripped everything from the Raspberry 
Pi 3 board and soldered flex cables to replace the 
bulky HDMI connector, with the electronics now 
housed by a 3D-printed case. 

While most hobby projects would have stopped 
there, the team went on to create a third prototype, 
based on a Compute Module 3+ Lite connected to 


Multi-touch display 

The CutiePi tablet features a 1280x800 MIPI-DSI 
display, with a five-point capacitive multi-touch 
panel. The user interface is built on top of Raspbian, 
and you can access the standard Raspberry Pi 
Desktop via a toggle switch. “When you toggle on 
over to our made-from-scratch, touch-friendly UI, 
you will have access to the CutiePi shell, including 
a WiFi settings manager, a Chromium-based 
web browser that supports all the common touch 
gestures, an on-screen keyboard with multiple 
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languages layout, and a terminal emulator, as part 
of our software version 1.0 release.” 

Penk tells us that in the future it will be possible 
to support native Raspberry Pi apps in the CutiePi 
shell through use of XWayland, a fully-fledged 
X server implementation for the Qt Wayland 
Compositor being used for the display. 

It all sounds very promising and, with the 
hardware parts near finalised, the team are 
focusing on the design for the final version of the 
tablet’s enclosure. They have decided to crowdfund 
the project in order to mass-produce CutiePi, so 
keep an eye on those crowdfunding sites for it. ED 


Amplifier 


WiFF/ET 


5TM32 MCU 


Gyroscope 

SO-DIMM socket 
for CM3/CM3+ 


> CutiePi gets its 
name from the Qt 
framework used 

> The carrier board 
features a sleep/ 
wake button 

> The CutiePi 
prototype uses a 
5000 mAh 

LiPo battery 

> A3D-printable case 
design file will be 
released very soon 

> A Raspbian image 
will also be made 
available for testing 


T The CutiePi carrier board 
for the Compute ModuLe 
3+ Lite is crammed 
with functionality 


Quick FACTS 


The OS is based on 
Raspbian, so you’LL be able 
to run standard applications 
and access a terminal to 
enter commands 


pieraspberrypi $ un&me 
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Qt Virtual Keyboard is 
used to generate the 
8-inch touchscreen’s 
keyboard 


A Chromium-based web 
browser supports all the 
common touch gestures 


3 D-printable files for the 
tablet case will be made 
freely available 



power management 
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Bit Time - Rotary 

Dial Phone Project 

A unique project in Essex explores how all ages engage with the tools that enable 
us to communicate, including using two upcycled retro phones, Nicola King dials in 



Dave Norton 
and Laura 
Trevail 


Dave is a Digital 
Artist and Drama 
Practitioner, and 
his work ranges 
from Large- 
scale interactive 
installations to Live 
theatre performed 
in a virtual world. 
Laura is an Artist 
and Context 
Strategist with an 
outdoor theatre and 
Live-art background. 

magpi.cc/bittime 


he Rotary Dial Phone project is part of 
a wider initiative called Bit Time - a 
project that has been running in Basildon 
over recent months. Lead artist Laura Trevail 
explains, “Bit Time is an intergenerational project, 
combining the skills and knowledge of the very 
young with those of our elders. As artists and 
facilitators, we’ve been bringing together these 
ideas and possibilities into playable works that in 
themselves keep that momentum going. These 
are projects about communication technology, 
but they are also communication technologies in 
themselves. By interacting with the art, you are 
interacting with each other. ” 

Cold calling 

So, the retro phones... where do they fit into this 
story? Phone project artist Dave Norton says, “The 


inspiration for the question/answer phones came 
from a desire to build a device that lets you share a 
message with someone you’ll never meet. A digital 
time capsule of anonymous thoughts, advice, 
stories, and memories that could be listened to 
by anyone. You have no idea who might hear your 
message and how it could affect them.” 

He explains how the system works: “You walk 
past a phone and it starts ringing, you pick it up 
and the operator asks you to answer a question, 
e.g. ‘what was your first phone?’, ‘what will a 
phone of the future look like?’ A ‘recording’ light 
comes on and you leave your message and hang 
up. Later on, you see another phone that also rings 
as you walk past; you pick it up and it plays back a 
random message left by someone else.” 

A motion detector identifies when someone 
walks past, while a push-button detects when the 




Triggered by a 
motion detector, 
each phone 
starts ringing 
when someone 
walks past it 


The question phone 
plays a random question 
to whoever picks up the 
handset and records 
their response 


The answer phone plays a 
random response recorded 
from the question phone 
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uue to power constraints, tne 
phone bell and recording sign have 
to be disconnected during bootup 


receiver is lifted. The phone’s mic and speaker 
are hooked up to a Raspberry Pi, which chooses 
a random audio file question to play. “The mic 
starts recording the user’s message for 15 seconds, 
or until they hang up, then the whole process 
restarts. The answer phone works in a similar way, 
but only chooses random audio files to play back. ” 
Since the installation needed to work in any 
kind of location, it couldn’t rely on WiFi to transfer 
audio files between the phones, particularly as the 
audio files needed to be checked manually before 
they could be shared with the public. “I ended up 
having to code a ( syncing’ mode, which is activated 
when a USB drive is inserted into Raspberry Pi, 
which automatically transfers all the audio files to 
the drive,” reveals Dave. 

□ Some people just hang 
up straight away, some 
people audibly freak out □ 

You talkin' to me? 

The Bit Time project, including the rotary dial 
phones, ultimately became an exhibition which 
toured Basildon in the summer of 2019. Dave says, 
“There’s something really unburdening about 
being anonymous, and something really pleasing 
about being given an open platform to speak your 


Dave says it was easy to snip the wires from each phone's speaker, 
mic, and hang-up button and connect them to Raspberry Pi 


mind. I loved the idea that the installation starts as 
a blank slate and, as it travels to different events 
and locations, it collects a mixture of stories and 
thoughts and shares them with anyone who cares to 
listen, something akin to a travelling storyteller. ” 
He says the phones elicited a variety of 
reactions. “Some people just hang up straight 
away, some people audibly freak out that they’re 
actually being recorded, some yell bizarre phrases, 
but most people genuinely answer the question. 

No two answers have been similar and it makes for 
some really interesting listening... We’ve ended up 
with hundreds of varied audio responses - it would 
be lovely to build some sort of audio installation 
using all the clips.” ED 


> The phones project 
took around three 
weeks to complete 

> Basildon Library 
Creator Space 
provided a location 
to construct the Bit 
Time artwork 

> A 5 V solenoid is 
used to ring each 
phone's bell 

> Dave programmed 
each Raspberry Pi 
using Python 

> He suggests the 
phones could be 
used in the foyer 
of a venue after 
an event, to glean 
honest views 
from attendees 


Bit Time - Rotary Dial Phone Project 
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RASPBER^Ui 

TIPS & TOOLS 


the range of tools 

HERE yourmaking'skills. by mark vanstone 


A 

Warning! 


Some of these tools use 
mains electricity and 
heated parts. Always follow 
connection instructions 
and never leave heated 
elements unattended. 


W hether you are new to making with 

Raspberry Pi or have been at it for years, 
there are always new tools and techniques 
to be learned. For the new arrival to the making 
community, this list will be a great resource to 
introduce you to tools that you may not have heard of 
before, and a short cut to get to the bits of software 
that work best for Raspberry Pi projects. If you’ve been 
doing this for a while, you may want to count how 
many of these tools are already in your makerspace. If 
you get to 50, you probably need a bigger makerspace. 
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iting something sol 
few years ago was 
ljl <e science fiction 


Affordable 
3D printing 


Pick up a copy of The 
Mag Pi #69 to Learn all 
about affordable 3D 
printing, magpi.cc/69 


3D PRINTER 


A The 3D printer is a fairly recent 

addition to the maker scene. To be 

able to print something solid a few 
years ago was like science fiction, but now 
it’s a reality. Printers come in many sizes and 
prices, so you can match your printer to your 
budget and requirements. There are several 
choices for filament too, such as PLA (a good 
beginner's choice) or ABS and many other 
more specialised types. If you have the time 
and patience, you can get a small unassembled 
one for less than £100, but for better quality 
(and less frustration) you may want to spend 
a bit more. 


Motors move the print- 
head and heated flat 
bed in three dimensions 
as the melted filament 
is built up in layers 


breadboard 


Breadboards are 
solderless circuit 
boards and allow for 
fast prototyping of projects. The 
boards come in several sizes 
and consist of a matrix of small 
connector holes into which 
components and jumper wires 
can be inserted to make circuits. 

magpi.cc/breadboard 


\ Some projects need to 
make a noise, and the 
sound quality depends 
on the type of speaker you use. 
There are small piezoelectric 
speakers if all you need are beeps 
and pops; alternatively, you may 
need a larger dynamic speaker. 

magpi.cc/piratemini 


\ LEDs (light-emitting 

diodes) are a bit like very 
small and efficient light 
bulbs. They glow when current is 
passed through them, but they 
need to be connected correctly. 
Because they are diodes, the 
current only flows one way, unlike 
in conventional light bulbs. 

magpi.cc/leds 
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_. 

RESISTUttSJ 


j Resistors are used in 

I electrical circuits to reduce 

1 current flow. They are 

1 used for many reasons, including 
changing the brightness of an LED. 

I They can be a fixed value, with 

I stripes to indicate the resistance; 

I or variable, with a slider or dial to 

1 change the resistance. 

\ 

? * 

\ 1 

1 magpi.cc/resistorkit 



diodes 


\ Diodes are known as 

semiconductors because 
they only conduct 
electricity in one direction. This 
can be useful for a number of 
reasons; for example, to protect 
your Raspberry Pi from being 
damaged if you are connecting 
it to motors. 

magpi.cc/diodes 


motors 


V When a current 
is applied to an 
electric motor, 
a spindle in the centre 
rotates. It spins because of 
an electromagnetic field that 
is caused by the flow of current. 

Motors come in all kinds of sizes, from 
mini drone motors to industrial ones 

magpi.cc/motors 




« 


SENSORS 

\ There are many types of electronic 

sensors. You may want to detect light 
or vibration, 
sound, or heat. There 
are sensors for all of 
these and many more. 

Sensors allow us to 
capture data about the 
world around us. 


magpi.cc/sensors 


CODE EDITOR 


There are several 
code editors 
for Raspberry 
Pi. IDLE used to be 
the standard Python 
editor in Raspbian, but 
now you might want to 


give Thonny or Geany a go. If you are feeling 
adventurous, you could try installing PyCharm. 

magpi.cc/texteditors 


SSH AND VNC 


If you want to run your 
Raspberry Pi headless 
(without monitor, 
keyboard, and mouse), you 
will probably want to connect 
to it by typing in commands 
using SSH, which provides a 
terminal, or you can have a 
windowed version with VNC. 

magpi.cc/vnc 
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TOOLS FOR 

building* 
prototyping. 

E9 Clamps 

For holding bits of your build together until it’s 
stuck or you need to change it. 


[ j balena cher 


Ch«o*kO HfcfW'lSa 



Crocodile clips 


Connect one component to another without 
soldering, tape, or breadboard. 


etcher 


Crimping tool 


Pinches connectors onto wire, fixing it to the 
connector. Can also can cut/strip wires. 


>9 Screwdrivers 

You’re going to need several different 
screwdrivers of different sizes/types. 


1 Craft knife 

Stanley knives are good for most work, but you 
might also want something lighter. 


9 Tweezers 

Tweezers can get you out of a fix when that little 
screw disappears. 


Q Hot glue gun 

Sometimes there is no substitute, but it’s not 
suitable for the young ’uns. 

O Hand drill 

Most of the time a cordless is best. 


m Saw 

Hacksaws for metal/plastic parts, jigsaw/ 
circular for big builds, mitre saws for angles. 


9 Pliers 

A good set of long-nose/snipe-nose pliers 
should be on hand at all times. 


30 | magpi.cc | 50 Raspberry Pi 4 Tools & Tips 


Because your Raspberry Pi generally relies on 
\ being booted from an operating system on a 
microSD card, you will require a way to write 
that data first. The open-source program you need for 
this is called Etcher from Balena. 

magpi.cc/Gtcher 


,f you are making any sort af moving.robot, 
you're probably going to need wheels 

y rn -- 
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TOOLS for storage 


W USB stick 

Add extra storage to your Raspberry 
Pi with a USB thumb drive. You can 
store more files than the microSD 
card, and you can transfer 
files from another 
computer to your 
Raspberry Pi. 



Em Memory card 

Make sure you have multiple microSD 
cards. An 8GB microSD card can be 
used to install Raspbian and other 
operating systems. It’s a good idea to 
have your regular microSD card 
and at least one other card 
for testing out projects. 


@ Storage box 

When making projects, you 
quickly rack up additional 
kit - not to mention cables, 
components, and Raspberry Pi 
boards. Keep everything in one 
place by adding a storage box 
to your shopping list. 


robotic 

CRAFT CUTTER 











CONDUCTIVEPAINT 


A CRYLIC & 

rrurpMOPLASTIC SHEET 


Electric Pal* 


Generally coloured black and supplied 
in a tube, this paint can be used to draw 
electrical circuits on paper or card, or to 
improve poor connections between components 
and even to create touch-sensitive areas on 
materials. Dries in a few minutes. 

magpi.cc/electricpaint 


polymorphic plastic 


\ This material is usually 
supplied as granules 
or beads. You can heat 
them up in boiling water and 
they will clump together in a 
mass. While still warm, you can 
mould the plastic before it sets 
hard in ten minutes or so. 

magpi.cc/polymorphicplastic 


V Acrylic plastic sheeting is very 
tough and can be cut using a 
saw or CNC router, whereas 
thermoplastic sheets are malleable when 
heated with a heat gun. Once cool again, 
thermoplastic retains its new shape. 

magpi.cc/plasticsheets 


Ir: . 
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L ^ S AT '■ 


PoV/<* "S 


aluminium foil 


\ Available from convenience stores and 
supermarkets, foil can be used as a 
conductor in a circuit, as shielding to 
reduce electromagnetic interference, and also 
to reflect light and heat either away from or 
towards an area. 

magpi.cc/alufoil 


tools for 

rnMNECTI NG ELECTR ONICS 


34 

GPIO ruler/chart 

35 

Header connector 

36 


GPIO (general-purpose input/output) 
pins are the interface between 
your Raspberry Pi and electronic 
components. Until you learn which 
pin is which, you’ll need a guide. 
There are several GPIO rulers and 
guides available to make life easier. 


For some projects, you may want 
to connect a HAT or pHAT to your 
Raspberry Pi, but not place it right 
on top of the board. In this case, 
a female-to-male 40-way ribbon 
connector enables you to extend the 
reach of the GPIO pins. 


Jumper wires 

Jumper wires connect Raspberry Pi 
GPIO pins to electronic components. 
Use them with a breadboard to 
prototype your circuit, or solder them 
directly to components. Be sure to get 
a variety of different colours to make 
your project easier to understand. 
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BLU TACK 


Usually used for 
keeping posters 
on walls, but can 
also be used for holding 
components in place 
while soldering. It also 
rubs out pencil marks if 
you don’t have an eraser. 


\ For temporarily 
holding things in 
place or insulating 
wires. You can also 
use tape for wrapping 
handles of tools. Also 
good for removing cat fur 
from jumpers. 


\ Similar to superglue, but is 

supplied with a brush to apply. 
Sticks most materials and very 
good for 3D-printed parts. Usually 
takes around half an hour to dry. 


magpi.cc/pmsticsheets 


tools for I 

TsOLDERING 


multimeter 


magpi.cc/multimeter 


You need to be able 
to measure current, 
resistance, and voltage in 
your circuits. Digital multimeters 
can cost as little as £10. 


gorilla glue 






Desoldering kit 


This equipment enables you to clean melted 
solder from components on a printed circuit 
board, allowing their removal or replacement. 


Soldering station 


A handy stand to place a soldering iron while it 
is still plugged in and hot. The sponge should be 
wet to clean the end of the iron. 


Soldering iron 


An absolute necessity for soldering or 
desoldering components onto printed circuit 
boards. For detailed work, an iron with a 
pointed end is best. 


Third hand tool 


Usually has a solid, heavy base with jointed 
arms with clips or holders at the end, and a 
magnifying glass for working on 
small components. 


NUTS, BOLTS & SCREWS 


Having a good range of sizes and shapes 
of nuts, bolts, and screws is absolutely 
necessary for making anything that you 
are not going to glue. Keep a jar full of spares. 


STICKY TAPE 
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POWER RANK / BATTERIES 


Most maker projects need 
^ power, so it is a good 
idea to have a range of 
battery holders. Power banks for 
recharging phones can also be 
used for 5 V supplies. 

magpi.cc/pimoronipowGr 


3D CREATION \ ~ 
SOFTWARE 

\ 


You may want 
to visualise your 


build before starting, and there are 
many 3D software packages to help you for 
free, like Blender; or with free trial versions, 
like SketchUp. 


fritzing 


When you have completed your 
project, you may want to document 
how you did 
it. Fritzing is a great 
program for laying out 
circuit diagrams. 

fritzing.org 


PAPER CLIPS 


V Can be used to connect 
components, clean 
out small nooks and 
crannies, or hold materials in 
place. Apparently, you can pick 
locks with them too! 


jL One of the most important tools you 
will use for just about any maker 
project is reference material. Your 
Raspberry Pi may have come with some tips 
and hints about making, and many kits have 
worksheets and Frequently Asked Questions 
sections with them. Also, make best use 
of the online resources that detail other 
people’s experiences: like Stack Overflow 
(stackoverflow.com) for information 
about any technical subject; blogs such as 
modmypi.com, recantha.co.uk, and 
blog.pimoroni.com; and of course the 
Raspberry Pi site (rpf.io) and magazines. If 
you’re stuck getting something to work, it’s 
likely someone else has had the same problem! 


The Official Raspberry Pi 
site is full of tricks, tips, 
and plans for making all 
kinds of projects with 
your Raspberry Pi 
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RETRO GAMING 

-WITH - 

RASPBERRY PI 

■ 

Retro Coming with Raspberry Pi shows you 
how to set up a Raspberry Pi to play classic games. 

Build your own portable console, full-size arcade 

■ 

cabinet, and pinball machine with our step-by-step 
guides. And learn how to program your own games, 
using Python and Pygame Zero. 


■ Set up your Raspberry 
Pi for retro gaming 

■ Emulate classic 
computers and consoles 

■ Learn to program 
retro-style games 

■ Build a portable 
console, arcade cabinet, 
and pinball machine 



BUY ONLINE: magpixc/store 
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Danny Staple 


Danny makes 
robots with his kids 
as Orionrobots 
on YouTube, and 
is the author of 
Learn Robotics 
Programming. 

orionrobots.co.uk 


You’ll Need 

> Lunchbox Robot 
with Camera 

magpi.cc/88 

> A neutral floor area 

> Good lighting 

> One of: 

Brightly coloured 
toy-boxes; 

300 gsm brightly 
coloured card 


Add navigation to 

your low-cost robot 

Make a robot that sees with computer vision! Take your 
first steps in QpenCV on a moving robot 


I n the last article, readers added a camera to a 
Raspberry Pi-powered lunchbox robot. They 
got a photo from the robot 5 s-eye view of the 
world. Now a robot builder gets to take this much 
further and make the robot use this camera to 
make decisions about the world. 

This tutorial shows how to make an 
environment for testing computer vision. It 
demonstrates using OpenCV to condition images, 
to remove noise and simplify them. Then readers 
see how to extract data or check the content of an 
image and use this to make a robot turn. 


A test course 

For trying out behaviours, robot builders 
make test courses. The goal is to create an 
environment with only the specific features to try 
out the robot. 

Find a floor area in a neutral colour. Somewhere 
white or grey without patterns or colour. 

Make walls with flat colours like red, blue, green, 
and yellow. Toy-boxes or coloured card work for 



Figure 1 


▲ Figure 1 The HSV coLour space 


this. Use white or neutral background walls. 
Cameras take better pictures with bright and 
consistent lighting. In good lighting, colours are 
clearer, making processing easier. 

Good options are daylight or bright white indoor 
lighting. Avoid tinted or patchy lighting. 


Installation 

This step may take some time. Plug a 
mains-powered USB adapter into the robot's 
Raspberry Pi before proceeding. 

Before installing the packages, make sure 
Raspbian is up to date with: 


sudo apt update -allow-releaseinfo-change 


There are some system packages needed for 
running the Python libraries. 

sudo apt install libcairo-gobject2 libwebp6 
libilmbase23 libgdk-pixbuf2.0-0 libjasperl 
libpango-1.0-0 libavcodec58 libavutil56 
libcairo2 libswscale5 libatkl.0-0 libgtk-3-0 
libtiff5 libpangocairo-1.0-0 libavformat58 
libopenexr23 libgfortran5 libatlas3-base 


Finally, install the Python packages needed for 
OpenCV, NumPy, and picamera: 

sudo pip3 install opencv-python-headless 
numpy imutils picamera[array] 


Set up the camera 

The function setup_camera in the file 
find_contours.py gets the camera ready. 
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□ Our robot's camera 
is upside down, so 
the rotation is set to 
180 degrees □ 


Figure 2 


n p l 




^ r 

DODD 


convert to 
HSV 


threshold 

saturated 

colours 




match with 
blue/yellow 


For quick processing time, and to simplify the 
image, line 11 sets a camera resolution of 128x128. 
Our robot's camera is upside down, so the rotation 
is set to 180 degrees. Using camera features saves 
processing on Raspberry Pi. 

Line 14 creates capture_buffer, space to store 
image data from the camera. Lines 15 and 16 start 
the camera with two seconds of warm-up time. 

With the robot in front of a coloured wall, run 
the following commands: 

export LD_PRELOAD=/usr/lib/arm-linux- 
gnueabihf/libatomic.so.1 
python3 find_contours.py 

This code send the camera's captured image to the 
file original.png 


A little colour theory 

Computers store colours as RGB or BGR, for 
red, green, and blue pixels. 

In find_contours.py, on line 21, we convert the 
image from BGR to the HSV colour system, which is 
suitable for this image processing. 

Figure 1 shows how HSV works. Saturation 
measures how vivid or intense the colour is, from a 
low value being white or grey, to a full value being 
vivid. Hue indicates the colour - red, orange, blue, 
green, yellow, etc. 

Transforming the image into HSV - Hue, 
Saturation, and Value - lets the robot pick out 
colour intensity (saturation) and then find its 
tint (hue), while mostly ignoring the colour 
brightness (value). 


A Figure 2 It takes 
a few steps for 
visual processing, 
with a number of 
transformations. A 
pipeline is a useful 
way to visualise this 
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find_contours.py 

DOWNLOAD 

THE FULL CODE: 

> Language: Python 3 

Q magpi.cc/robotCV1 

001 . 

import time 


002 . 

import imutils 


003. 

import numpy as np 


004. 

import cv 2 


005. 

from picamera.array import PiRGBArray 

006. 

from picamera import PiCamera 


007. 



008. 



009. 

def setup_camera() : 


010 . 

camera = PiCamera () 


011 . 

camera.resolution = (128, 128) 

012 . 

camera.rotation = 180 


013. 



014. 

capture_buffer = PiRGBArray(camera, size=(128, 128)) 

015. 

camera. start_preview( ) 


016. 

time.sleep( 2 ) 


017. 

return camera, capture_buffer 


018. 



019. 



020 . 

def get_saturated_contours(image) : 


021 . 

hsv = cv2.cvtColor( image, cv2.C0L0R_BGR2HSV) 

022 . 

# Mask for vivid colours 


023. 

masked = cv2.inRange(hsv, np.array([0, 140, 30]), 


np.array([255, 255, 255])) 


024. 

# Find Contours 


025. 

cnts = cv2.findContours(masked.copy(), cv2.RETR_EXTERNAL, 


cv2.CHATN_APPROX_SIMP L E) 


026. 

contours = imutils. grab_contours(cnts) 

027. 

contours = sorted (contours, key=cv2.contourArea, reverse=True) 

028. 



029. 

colour = [ 0 , 0 , 0 ] 


030. 

if len( contours) > 0 : 


031. 

# Find the center of the contour 

032. 

m = cv 2 . moments (contours[ 0 ]) 

033. 

if m[ n 00 "] > 0 : 


034. 

cx = int(m[ nil ] / m["m 00 ]) 

035. 

cy = int(m["m 01 "] / m["m 00 "]) 

036. 

colour = hsv[cy, cx] 


037. 

return masked, contours, colour 

038. 



039. 



040. 

if _name_ == '_main_' : 


041. 

camera, capture_buffer = setup_camera () 

042. 

camera. capture(capture_buffer , 

, format="bgr") 

043. 

image = capture_buffer.array 


044. 

masked, contours, found_colour = 

= get_saturated_contours(image) 

045. 

cv2.imwrite( 'original.png', image) 

046. 

cv2.imwrite( 'masked.png' , masked) 

047. 

cv2.drawContours(image, contours[:1], -1, (0, 255, 0), 1) 

048. 

cv2. imwrite( 'with_contours.png' , image) 

049. 

print (found_colour) 




▲ Figure 3 Example of a masked or threshoLded image. 
PixeLs are only on (white) or off (bLack) 


Image processing pipelines 

The code processes images from the camera 
through a series of transformations to find the 
colour of a wall. Each transform is a small step; for 
example, finding all the pixels that match a criteria 
or making an outline of an area. 

Later stages use the transformed output of 
earlier ones. The outputs are joined to other inputs, 
forming a pipeline. 

A diagram like Figure 2 (previous page) shows 
where data flows from one process to another, 
making it easier to understand what is going on. 
Use images from real outputs, boxes for stages, and 
lines to show the flow of data. 


Thresholding or masking 

Thresholding tests if every pixel has values 
within a range. Line 22 of find_contours.py uses 
cv2. inRange for this. It makes a new binary image, 
storing True if the pixel has values between the 
lower limits and the upper limits. 



▲ Figure 4 This is the original image, after a contour has been 
found from the threshold image and drawn back on it 
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The find_contours.py range allows all hue 
values while filtering for saturation values over 
140, for only vivid colours and the value component 
to values brighter than 30. 

The output file masked.png shows the output, 
with coloured walls in white (see Figure 3 for 
an example). 

The S and V values of the lower bound on line 22 
can be adjusted up if too much area is matching, or 
down if too little is. 

□ OpenCV can inspect a 
black and white image and 
find outlines for different 
areas, It calls these 
outlines contours □ 


Finding contours 

OpenCV can inspect a black and white image 
and find outlines for different areas. It calls these 
outlines contours. 

In find_contours.py, lines 28 and 29 obtain a 
list of contours. Each contour is a list of points 
describing the outline. 

On line 30, the contours are sorted by area. By 
finding the first contour in this list (the biggest), 
the code has likely found the most significant 
coloured area. 

On line 48, the contour is drawn out to a debug 
image with_contours.png. Run the code and 
download the image to see how the contours look 
(see Figure 4 for an example). 



▲ Figure 5 A hue colour wheel is handy for looking up colours. 
The figures under the degrees show the OpenCV values 


Finding the colour 

For this code to choose by colour, it needs 
the hue from the middle of the contour. It takes 
this colour from the original picture. 

The robot uses OpenCV moments for finding the 
middle of a contour. 

By dividing the sum of X coordinates (mie) by 
their count (m00), the code obtains the average X, 
their centre. The code also obtains the average 
and centre of the Y coordinates (m0l divided by 
m00). The middle of the contour comes from 
combining these. 

The code on line 36 of find_contours.py extracts 
the colour from the hsv output at the middle of 
the contour. 


Top Tip 4 


Lighting matters 


Lighting should be 
neutral in colour, 
bright and diffused. 
Spotlights, Low 
Light, and coloured 
Lights cause 
problems with 
visual processing. 


Using the pipeline in a robot 

The get_saturated_colours function is 
imported from find_contours.py, enabling this 
code to reuse the pipeline from already tested code. 


camera_nav.py 

DOWNLOAD 

THE FULL CODE: 

> Language: Python 3 

Q magpi.cc/robotCV2 

001 . 

import gpiozero 


002 . 

from camera_setup import setup_camera 

003. 

from find_contours import get_saturated_contours 

004. 



005. 

robot = gpiozero. Robot (left=( 27, 

17), right=(24, 23)) 

006. 

camera, capture_buffer = setup_camera() 

007. 



008. 

for raw in camera. capture_continuous(capture_ 

009. 

buffer, format="bgr' ): 


010 . 

image = raw.array 


011 . 

masked, contours, found_colour = get_saturated_ 

012 . 

contours (image) 


013. 

print (f "Colour {found_colour}, h value: {found_ 

014. 

colour[0]}") 


015. 

if 5 < found_colour[0] < 40: 


016. 

print ("yellow ) 


017. 

robot.left() 


018. 

elif 100 < found_colour < 135: 

019. 

print("blue' ) 


020 . 

robot. right() 


021 . 

else: 


022 . 

robot.forwardQ 


023. 

capture_buffer.truncate(0) 
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A continuous stream of images is needed to 
use the pipeline to drive the robot. Line 8 of 
camera_nav.py creates this stream; line 9 extracts 
the data. Line 8 sets up the main loop as a for loop 
that runs forever with a new image each time. 

The main loop puts the image through the 
pipeline and uses the output to determine if 
the robot turns right, left, or goes forward. The 
camera’s image rate sets the timing. 

The colour returned by get_saturated_colours 
is HSV. 


Matching the colour 

The camera_nav.py code uses the hue 
component from get_saturated_colours. 

OpenCV stores a hue value as degrees divided by 
2 to fit into 8 bits (up to 255). Figure 5 (previous 
page) shows a colour wheel with hue values in 
degrees and OpenCV values. 

The code in camera_nav.py matches a yellow 
range on line 12, and a blue range on line 15, 
printing the matched colour and turning the robot. 

By setting up a series of walls of different 
colours, the robot can now navigate by wall 
colours. Expect to change these ranges for different 
test areas. 

Ensure the robot is on battery power and in the 
test course before running this. 



canny horizon 28 . 0 ° 


▲ Extending the pipeline 
leads to detecting edges 
and finding the angle of 
the horizon. This could 
be used to line a robot 
up with a wall 



□ A continuous stream 
of images is needed to 
use the pipeline to drive 
the robot □ 


Improving robot vision 

The find_contours.py code is a simple 
demonstration of computer vision. It’s also easy to 
confuse it. Finding the image under the contour and 
averaging the colour would make it more stable. 

The code could be combined with distance 
sensors, so only walls close enough were detected. 
Encoders or an inertial measurement unit (IMU) 
could be added to make a precise turn. 

Advanced techniques like Canny Edge Detection 
with HoughLines could pick out the horizon, 
determining the angle and distance, so the robot 
could line up with a wall. OpenCV can do face 
detection and even has machine learning and 
neural network modules. 


Further reading 

Robot vision is a significant area of study 
in robotics, and this article has barely scratched 
the surface. It’s one of the more rewarding 
and exciting spaces of robotics, worthy of 
further reading. 

The PylmageSearch site (pyimagesearch.com) 
is a superb resource to learn more about computer 
vision and dig further into detecting different 
attributes from an image. 

Your article author’s book, Learn Robotics 
Programming , has a section on computer vision, 
building face- and object-following behaviours, 
and casting the camera and pipeline stages to a 
mobile phone browser to view in real time. ED 


Top Tip 


Reduce background clutter 


A cluttered background causes the robot to detect 
random things. Neutral backgrounds without 'noise' 
make this easier to test. 
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MORE POWER TO STRATO PI AND IONO PI! 


Strato Pi is a line of servers based on Raspberry Pi for the development of distributed/decentralized 
field control solutions. It is ideally suited for industrial applications where extreme reliability, 
ruggedness, and compliance with technical and safety directives are required. 

lono Pi is an extremely versatile I/O module that combines several digital and analog input lines, 
power relay outputs, and support for standard interfaces, typical of a modern PLC, with the 
powerful computing core of the Raspberry Pi. 


On the trail of the new Raspberry Pi 4, we upgraded our products to fit its new design and 
capabilities. The re-engineered power-supply stage withstands the current demand of Raspberry Pi 
4, including that of external devices powered via USB or through the auxiliary power supply output. 
The DIN-rail case now fits the new USB and Ethernet ports layout, as well as the new micro HDMI 
ports and USB-C power supply. 



The new Strato Pi and lono Pi are available on our website with pre-assembled Raspberry Pi 3 B+ or 

Raspberry Pi 4 2GB and 4GB. 

Find out all the details on our website www.sferalabs.ee! 


LABS 

www.sferalabs.ee 
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Smart classroom 

assistant 



Dale 

Lane 


Dale works for 
IBM and created 
the Machine Learning 
for Kids web- 
based tooL. 


magpi.cc/MLforkids 


Create Al in Scratch using Machine Learning for Kids, 
and find out how machine learning really works! 


I n this project, you will use the 
Machine Learning for Kids tool 
(machinelearningforkids.co.uk) to make a 
smart virtual classroom assistant that reacts to 
what you say to it. You’ll be able to control the 
classroom’s virtual devices by typing in commands! 

First, you’ll create an assistant that uses a list 
of rules for understanding commands, and you’ll 
learn why that approach isn’t very good. 

Next, you will teach the assistant to recognise 
commands for different devices by training it 
using examples of each command. 



Get started 

Head to machinelearningforkids.co.uk 


Create a project 

Click on Projects in the menu bar at the top, 
and then click on the '+ Add a new project’ button. 
Name your project 'smart classroom’ and set it to 
learn to recognise text, then click on Create. You 
should now see 'smart classroom’ in the projects 
list; click on this project. 


Prepare the project 

Now we need to get a project ready in 
Scratch. Click on Make, click on Scratch 3, then 
click on 'Scratch by itself’. The page then warns 
you that you haven’t done any machine learning 
yet. Ignore this and click on 'Scratch by itself’ to 
launch Scratch. 



in a web browser. You’ll then need to click on 'Get 
Started’, and then click on 'Try it now’. 


You can 

find this project 
and others on the 
Raspberry Pi 
Projects website! 


magpi.cc/projectsonline 


Finally, click on 'Project templates’ and then 
click on the 'Smart Classroom’ template. 
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A Figure l Click on 
'classroom' in the 
Scratch sprites pane 


Add a list of rules 

In this step, you will edit the project to 
include a list of rules to activate and deactivate 
the fan and the lamp. Click the classroom sprite 
to select it, as shown in Figure 1. Click on the Code 
tab and create the script shown in Figure 2. Once 
you’ve done that, click on File and then on ‘Save to 
your computer’, and save the program to a file. 


First tests 

Click on the green flag to test your program, 
and then type in a command and watch the program 
react! The following commands should all work: 


□ The problem with this 
rules-based approach is 
that you need to exactly 
predict all the commands □ 


A Figure 2 The Scratch 
code for a rules- 
based approach 



Turn on the lamp 
Turn off the lamp 
Turn on the fan 
Turn off the fan 

Type in anything else and your program does 
nothing! Even if you make a small spelling 
mistake, the program does not react. 


Beyond rules 

You’re telling your virtual classroom 
assistant to react to commands using a simple 
rules-based approach. But if you wanted your 
program to understand commands that are 
phrased differently, you would need to add extra 
‘if’ blocks. 

The problem with this rules-based approach is 
that you need to exactly predict all the commands 
the smart classroom assistant will understand. 
Listing every possible command would take a very, 
very long time. 


if answer = 


Turn on the fan 


broadcast turn-fan-on ♦ 


if answer - 1 


broadcast turn-fan-off 


if answer - 


broadcast turn-lamp-on * 


if answer = 1 



1 off the lamp 


broadcast turn-1 amp-off ▼ 



Top Tip A 


Machine 

learning 


You need to tell 
an Al what to 
learn. The more 
you give it to learn 
with, the better it 
will be. 
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□ The more examples 
you give your program, 
the better the program 
should get at recognising 
your commands □ 

Next, you will try a better approach: teaching the 
computer to recognise commands by itself. 


Examples for training 

Close the Scratch window and go back to the 
Training tool, then click on the '< Back to project’ 
link. Click on the Train button because you need 
to collect some examples so that you can train the 
computer. To collect different examples, you need 
to create 'buckets’ to put the examples in. 

To create a bucket, click on '+ Add new label’ and 
call the bucket 'fan on’. Click on '+ Add new label’ 
again and create a second bucket called 'fan off’. 
Create a third and a fourth bucket called 'lamp on’ 
and 'lamp off’. 

Click on the 'Add example’ button in the 'fan 
on’ bucket, and type in a command asking for the 
fan to be turned on. For example, you could type 
'Please can you switch on the fan’. For the 'fan 
off’ bucket, you’ll need to click 'Add example’ 
again and then use something like 'I want the fan 
off now’. Do the same for the 'lamp on’ and 'lamp 
off’ buckets. 


More examples for more training 

Continue to add examples until you have at 
least six examples in each bucket. Be imaginative! 
Try to think of lots of different ways to ask each 
command. For example: 


For Jan on] you could complain that you’re too hot. 
For Jan off] you could complain that it’s too breezy. 
For ( lamp on] you could complain that you can’t see. 
For damp off] you could complain that it’s too bright. 


More is good: the more examples you give your 
program, the better the program should get at 
recognising your commands. 

Use equal numbers: add roughly the same 
number of examples for each command. If you 
have a lot of examples for one command and 
not the others, this can affect the way that the 
program learns to recognise commands. 

Make the examples really different from each 
other: try to come up with lots of different types of 
examples. For instance, make sure that you include 
some long examples and some very short ones. 


Start the training 

You will now train the program using the 
examples, and then test it. The program will learn 
from patterns in the examples you give it, such 
as the choice of words and the way sentences 
are structured. Then, based on the patterns the 
program finds, it can interpret new commands. 

Click on the '< Back to project’ link, then click 
on 'Learn & Test’. Click on the 'Train new machine 


► The Smart Classroom 
template is used to 
program the model in 
Scratch 3 
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Recognising text as fan_on, fan_off or 2 other classes 



▲ Add as many different and varied exampLe phrases as you can 
for each command 


learning model’ button. If you have enough 
examples, the program should start to learn how to 
recognise commands from these examples. 


Test the training 

Wait for the training to complete. This 
might take a minute or two but once the training 
has completed, a test box appears. Test your 
machine learning model to see what it has learned 
by typing in one of the commands you added to 
a bucket, and then press ENTER. The command 
should be recognised. 

Now type in commands that are not in the 
buckets. If you’re not happy with how the 
computer recognises the commands, go back to 
the previous step and add some more examples. 
Then select the 'Train new machine learning 
model’ button again. 

Instead of writing rules for the program, you are 
giving the program examples. The program uses 
the examples to train a machine learning model. 
Because you are supervising the program’s 
training by giving examples, this machine learning 
approach is called supervised learning. 


Use it in Scratch 

Now update your Scratch program to 
include your machine learning model instead of 
the rules-based approach. Click on the '< Back 
to project’ link, click on Make, then Scratch 3. 

Here you can read the instructions on the page 
to learn how to use machine learning blocks 
in Scratch. 

Click on Open in Scratch 3, then on File and 
'Load from your computer’, and select the 
Scratch project you saved earlier. When Scratch 
asks you whether to replace the current project, 
click on OK. 

Click on the Code tab, and update your Scratch 
code (Figure 3) to use your machine learning model 
instead of the rules you first added. The 'recognise 
text’ block is a new block added by your project. 





H 

fan_off then 





This new block can receive a message and return 
one of the four labels, based on the machine 
learning model you have trained. 


Figure 3 Revised for 
a machine Learning 
approach, the code 
features 'recognise 
text’ blocks 


Scratch Al 

Click the green flag to test your new code. 
Test your project by typing a command and 
pressing ENTER on your keyboard. The fan or lamp 
should react to your command. 

Make sure you test that this works even for 
commands that you didn’t include as examples in 
the buckets. 

Save your project as before. Your Scratch smart 
virtual classroom now uses a machine learning 
model instead of a rules-based approach. Using 
machine learning is better than using rules, 
because training a program to recognise commands 
for itself is much quicker than trying to make a list 
of every possible command. 

The more examples you use to train the machine 
learning model, the better your program should get 
at recognising commands. 


If you want to learn about how you can improve 
the model with 'confidence scores’, head here: 

magpi.cc/smartclassroom ED 


Top Tip 4 


Go further 


Can you get the 
model to tell you 
the weather or 
date? Give it a go! 
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Add internet access 

to a vintage computer 



pj 

Evans 


PJ is a writer, coder, 
and Milton Keynes 
Raspberry Jam 
wrangler. In the 
dial-up days he 
created pages for 
Prestel, which ages 
him greatly. 

■ @mrpjevans 


You'll Need 


> MAX3232CPC 
RS232 transceiver 

magpi.cc/MAX3232 

> Small piece 
of stripboard, 

eg magpi.cc/ 
stripboard 

> 5 x 100nF 
capacitors 

magpi.cc/1 OOnF 

> 1 x g-pin D-sub 
socket 

magpi.cc/D-sub 

> lx PL2303-based 
USB/RS232 cable 
(optional) magpi.cc/ 
USB-RS232 

> Jumper Leads 
(socket ending) 


Missing dial-up? Want to post to a BBS? Build an interface 
to the modern world for your old computer with a Pi232 


T he bulletin boards of the 1980s haven’t 
died out quite yet, but they have gone 
online. There’s only a handful of BBSes 
(bulletin board systems) that you can dial up 
with your old-time modem. If you like the idea 
of accessing an internet-based BBS from your 
Atari ST, Amiga, or BBC Micro, then we can use a 
Raspberry Pi computer to act as a translator. You 
can even use modern services like Twitter! All we 
need to do is get Raspberry Pi talking in one of 
the most popular communications protocols of all 
time: RS232. 


A little history 

Every Raspberry Pi computer has a form 
of serial access, which is one of the oldest and 
simplest ways of communicating with computers. 
These days you’re more likely to use TCP/IP, 
the protocol of the internet, to chat to a remote 
device, but back in the day it was RS232 that 
ruled the communications world. Raspberry Pi 


circuitry features a further simplified version 
often referred to UART (universal asynchronous 
receiver/transmitter) running at 3.3 V, but we 
can adapt it to ‘full’ RS232 at 12 V so that older 
computers can handle the signal. 


Study and shop 

To ‘downgrade’ a Raspberry Pi to RS232, 
we’ll need to build a small circuit to act as a 
transceiver so the vintage computer can ‘hear’ 
our virtual modem and the RS232 signals do not 
fry our delicate Raspberry Pi board. Luckily, all 
the heavy lifting for such a job can be done by the 
MAX3232CPC integrated circuit. All you need to 
do is wire it up, add a few capacitors, and you’ll 
be BBSing in no time. Have a look at the circuit 
diagram (Figure 1, overleaf). We’ve deliberately 
made it larger than it needs to be for simplicity. 
More experienced makers will be able to reduce it 
in size if they wish. 



▲ Cheat #1: If you don't fancy soldering, you can buy these pre- 
assembled units (for a few pounds) that can connect to the GPIO 


Soldering the main circuit 

Time to get building. Thankfully, the 
circuit itself is not very complicated, but it’s 
also unforgiving, so make sure all the wiring is 
in the correct place or nothing will work! We 
recommend starting with the IC socket, then the 
wiring, followed by the capacitors, finishing with 
the headers (optional if you’d like to use jumper 
cables). The result takes the two transmit (TX) and 
receive (RX) lines from the GPIO and feeds them 
into the IC. The MAX3232CPC converts the data 
into RS232 standard and outputs them to the 9-pin 
D connector and vice versa. Check and double¬ 
check everything. 
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Many 1980s and 1990s 
computers came with a 9- or 
connector; the 
LL widely used today 


By interfacing the Raspberry 
Pi computer UART interface 
to RS232 and then using WiFi, 
we bridge the gap between 
old and new technology 


Add connectors 

Unless you're going for a permanent setup 
or looking to make it as low-profile as possible, 
we recommend using DuPont-style jumper cables 
to connect the circuit to your GPIO. Which model 
of Raspberry Pi you use is up to you, but unless 
you have a specific use case in mind, a Raspberry 
Pi Zero W is the perfect choice as it's small and 
there's little horsepower required. You will also 
need to solder up the 9-pin D connector. The 
diagram (Figure 1) shows the connector from the 
solder (rear) side. Make sure you wire up correctly 
to pins 2 and 3 and ground it too. 


□ The circuit itself is not 
very complicated, but it's 
□Iso unforgiving □ 



A Cheat #2: The 
simplest solution 
of all is the widely 
available USB-to- 
RS232 cables based 
on the Prolific 
PL2303 chipset 


Raspberry Pi time 

Your Raspberry Pi Zero W will need a bit 
of configuration before you can get going. Start 
with a fresh microSD card with Raspbian Lite (we 
don't need a desktop, but feel free to install 'full' 
Raspbian if you wish). This is also a great project 
for reusing any old low-capacity microSD cards 
you have, as there’s not much software to install. 
Once booted up, make sure everything is up to 
date by running sudo apt -y update && sudo apt 
-y upgrade. Time to grab a refreshing beverage as 
Raspbian applies all the latest updates. 


Prepare your virtual modem 

An 'out of the box' Raspbian installation 
isn't quite ready to go back to the 1980s just yet, so 
we need to do a little further configuration. From 
the command line, run sudo raspi-config to start 
the Raspberry Pi configuration utility. From the 
top of the menu, start by changing your password 
(optional, but recommended); then, under Network 
Options, set your host name (again, optional) and 
configure WiFi. Finally, under Interfacing Options, 
enable SSH and Serial. When asked 'Would you like 
a login shell’, select 'Yes'. Now exit the utility and 
shut down the computer (sudo shutdown). 


Top Tip 4 


Not just 
vintage 


This project works 
well with older 
PCs. Although 
they refer to 
them as COM 
ports, their 9-pin 
connectors are 
really RS232. 
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Many classic BBSes 
are still online, some 
even supporting 
PSTN modems. These 
days, most can be 
found at the end of an 
IP address 


rfif.fiCLCS! 


main 


menu 


) configure your account 
) read message boards and mailbox 
) chat ice breaker 
) play online games 
u ) the uoting booth 
n ) news from the sysop 
h ) logoff 


Particles Main 


-pause-_ 

Particles 


) transfer file menu 
) send feedback to ice breaker 
) search for a BBS user 
) information about particles! 
) the last callers 
) read text files 
) also logoff 


I Telnet I Connected: 00:01:55 I CMD-Z for mend 


T Figure l Here's the 
circuit we're going 
to build. It's not too 
complex, but it's 
imperative that the 
wiring is hooked up 
correctly. Check and 
double-check 


Testing time 

Check your circuit board for any short 
circuits or dry solder joints. Once happy, connect 
it to the GPIO. There are four connection points: 
one for 3.3 V (physical pin 1), ground (pin 9), and 
TX/RX (pins 8 and 10 respectively). We recommend 
getting an RS232/USB cable and testing with 
a modern computer first. Connect the 9-pin 
connectors together and boot your Raspberry 
Pi. Now, using your favourite Terminal emulator 
program (we like Serial for macOS), try to connect 
over RS232. Raspbian’s default settings are 
115,200bps (connection speed), eight data bits, no 
parity, one stop bit (aka 8N1). 



RXD 

TXD 

GND 


Raspberry PI RS232 Adaptor 


Raspberry Pi GPIO 


PI - +3.3V 


Figure 1 


9-Pin D (Solder Side) 


Troubleshooting 

Having problems? RS232 can be a tricky 
beast as, unless everything is perfect, nothing 
will work at all. The most common issue will 
be polarity of the TX and RX lines. For things to 
work, the RX of the GPIO must be connected via 
the MAX3232CPC to the TX line of the computer 
and vice versa. Start by checking that your speed 
is correct and the protocol is set for 8N1. Also try 
‘reset’ or ‘send break’ in your terminal emulator, 
which is sometimes needed to wake up the 
connection. Finally, try using a null modem cable 
(which crosses over the lines) or swapping the 
connectors to pins 8 and 10. 


Get online 

If everything is working, you should now 
be greeted with the Raspbian terminal login (you 
might need to press ENTER a couple of times to 
wake it up). You can now log in as normal. If the 
connection is behaving, feel free to try it out on a 
real vintage machine. Some may require adapters 
to connect (1990s home computers favoured 25-pin 
D connectors). You will probably need to reduce the 
speed of the connection, as many older computers 
cannot handle the default 115,200bps. Unless your 
computer is very old, 9,600bps will probably work. 
To set the port to this, enter the following from an 
SSH session: 


sudo stty -F /dev/serial0 9600 
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Connect to a BBS 

Most BBSes are now online and talk using 
a protocol called Telnet. It is very insecure, 
sending plain text over the internet and has since 
been replaced with SSH (Secure Shell). However, 
many of these services are being run on original 
equipment that has no support for SSH, so Telnet 
it is. The Telnet client software is not installed by 


default, so run sudo apt install telnet. Once 
finished, try connecting to the popular Particles 
BBS (running on an Apple II/e!), by entering: 


□ For □ genuine experience, 
□nd full compatibility with 
vintage BBS software, it's 
easy to emulate the classic 
Flayes AT command-set □ 


▲ Polarity is the most 
common problem 
encountered when 
working with RS232. 
Remember that TX 
(transmit) goes to 
RX (receive) and 
vice versa 


tcpser /dev/serial0 -s 9600 -1 7 


telnet particlesbbs.dyndns.org 6400 

Within a few seconds you’ll see a welcome 
message. After you’ve had a look around, use 
CTRL+ ] followed by 'exit’ to leave Telnet. 


(You can change 9600 to be your desired speed). 
Try connecting over serial again and this time 
you’ll be able to enter AT commands, replacing 
phone numbers with domain names. 


Emulate a classic modem 

If you want a genuine experience, and full 
compatibility with vintage BBS software, it’s easy 
to emulate the classic Hayes AT command-set. To 
install the emulator: 


sudo apt install tcpser 

Before running tcpser, go back into raspi-config, 
select 'Interfacing Options’, then 'Serial’, and 
answer 'No’ when asked if you want a login shell to 
be accessible and then 'Yes’ if you want the serial 
port to be enabled. Now start tcpser using SSH: 


□0 more! 

Your original 'comms’ software should 
be blissfully unaware that it is talking over the 
internet. There’s now another web of vintage 
BBSes to explore on your original machine, but 
why stop there? The Raspbian repositories are full 
of command-line software that can be accessed by 
your classic machine. Tweeting from an old 8-bit is 
always fun, so why not install't’, a command-line 
Twitter client (github.com/sferik/t)? Of course, 
you can now do anything in the Raspbian shell 
that you can in an SSH session, so get your BBC 
Model B to operate LEDs and switches, or have your 
Commodore Amiga send Telegram messages! EU 


Top Tip 4 


Careful of 
weird wiring 


Do your research 
on your choice of 
classic machine. 
Some, such as 
the Cambridge 
Z88, use non¬ 
standard wiring to 
their connectors. 
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Warning! 

Drill safely 


Please use safety 
goggles and a desk 
damp when drilling 

You'll Need 

> Stripboard 

magpi.cc/ 

stripboard2 

> 40-pin, 2-row 
header pins 

magpi.cc/2rowpins 

> 2 x 40-pin, l-row 
header pins 

magpi.cc/irowpins 


Hack GraviTrax 

with Raspberry Pi 

Make your GraviTrax layout trigger LEDs 
for a dazzling sound and light show 


I n the first part of this series, we explored how 
to monitor the presence of a ball and how to 
use that to trigger sound. Then, last month 
we saw how to make animated LED parts run in 
background threads. Now we bring these two parts 
together and show you how to control them both 
using a text script and interface board. 


Making the connection 

In the first part (magpi.cc/87), we 
simply mentioned that the ball sensors had to 
be connected to the GPIO pins with an external 
pull-up resistor and left it at that. Likewise, 
we just used several I 2 C devices on the same 
bus. However, for a practical useable system, 
we need to have all the input and output on a 
single board that allows simple flexibility for 
setting up different track layouts. So, we have 
designed a board which allows us to connect up 
to twelve sensors, five I 2 C devices, and eight 
NeoPixel channels. 


The schematic 

The schematic (Figure 1) might look a bit 
repetitive, but that is the nature of what we are 
making. First of all, it incorporates the NeoPixel 
driving board we saw last month, but adds an 
option for powering the LEDs from an external 
supply to allow for much brighter displays. Then 
we have the input connectors: each has a 5.6kQ 
(5K6) pull-up resistor to 3.3 V (3V3) on the GPIO 
input pin. Note the centre pin is 3.3 V and the end 
pin is the input. Finally, we have five distributing 
I 2 C connectors running on a single set of I 2 C 
drivers, which also carry 5 V power and ground. 


Beginning the board 

We used a piece of 39-row by 37-hole 
stripboard to make our distribution board, and a 
small length of 40-way ribbon cable to connect it 
to our Raspberry Pi. Figure 2 (overleaf) shows how 
we cut the tracks on the rear of the board. Note 
the cuts between holes we used for the ribbon 
cable’s header pins; we did this with a scalpel, 
but you can use a small sharp knife for this - be 
careful! We found the best way to do this was to 
make two cuts across the track as close together 
as we could, and then remove the copper in 
between them with the blade. 

□ We have designed a board 
which allows us to connect 
up to twelve sensors, 
five l 2 C devices, and eight 
NeoPixel channels 3 


03 


Optional power jack 

Wear goggles for this step 
If you want to include a power jack for an external 
5 V supply for the LEDs, we recommend you 
prepare for that first. Unfortunately, the standard 
board-mounting jack connectors are not too 
friendly for being mounted on a 0.1 inch pitch 
board, and you need a bit of work to make it fit. 
We found the best way is using a 1 mm routing bit 
in the drill; or, at a push, a Dremel. You need to 
run together several holes in order to make this 
fit. Figure 3 (overleaf) shows what you need to do. 
We recommend you practise this on a small scrap 
of stripboard first before you attempt it on the 
large board. 
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GraviTrax awaiting fitting 
of Lights and sensors 


r 


— — — 


The interface board 

that we've built 




_ 


Construction 

When faced with a large piece of stripboard, 
it is easy to get disorientated, so start by cutting 
the tracks for the header pin and soldering that 
to the board. Then cut the tracks for the two IC 
sockets and solder them in. This will give you a 
couple of good points of reference when building 
up the circuit. The final layout you are aiming for 
is shown in Figure 4, but we suggest you leave 
the flexible wires until last. If you want to see 
the layout before the flexible wires, there is an 
intermediate diagram on our GitHub page. 


Construction order 

We suggest that you first put in the copper 
wire links, shown as black lines. Then cut the 
tracks on the back. These are shown on the front 
view diagram as grey rectangles. Push a wire from 
the front into the hole of the track you want to cut, 
flip the board over, and cut the track at the point 
the wire shows. This way, we have found there 
is less chance of getting it wrong. Then add the 
header pins, followed by the resistors, capacitors, 
and power jack. 


Make link to power the LEDs 
from the Raspberry Pi 


Raspberry Pi GPIO number 
(connector number) 


| O.luF 


| O.luF 


J 


lOOOuF 

6.3V 


f T_ 


Optional 

2.1mm Power Jack 


Figure 1 


X 


GPIO 11 (23) 
GPIO 9 (21) 
GPIO 10 (19) 
GPIO 18 (12) 


Gnd (6 & 14 & 
22 & 30) 


3 

[> 

4 PB1 

5 

b^ 

r>. 

6 PB2 

11 


10 9 


8 

13 


12 

— N/C 

b^ 

1 7 




iUUt 

lnput 3V3 Gnd 


WS2812b LED 
Strip Outputs _ 


-mm- 




11111 


All 

270R 


All 

10K 


WS2812 connectors 


+5V Gnd 
Output 


|—5K6 i—I 



Figure l Here's a schematic of the interface board used in this project 
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Figure 2 


39 BO 20 10 1 


bio 



A Figure 2 These are the tracks to cut on the rear side of the stripboard. Be careful! 



Figure 3 


A Figure 3 Here's what cutting the slots for the power jack looks Like. Once again, be careful 


Flexible wiring 

In order to complete the board, you need 
to add flexible wires to make the connections not 
made by tracks alone. Note that the layout diagram 
is designed to show what connections you need 
to make, and not necessarily what route they 
should take. For example, header pins 19, 21, and 
23 are shown going over the top of the header; in 
practice, they should be routed round the left- 
hand side of the header pins, or even soldered on 
the underside of the board. Electricity is famously 
indifferent as to what colour wire it flows through 
- the colours we used are just to make the diagram 
more readable. 


Finishing off 

We gathered the wires together using small 
2mm-wide cable ties. This is essential to prevent 
the wires resting in between the header pins and 
making them look untidy. We also gathered the 
wires away from the edges of the board to allow 
labels to be put onto the board. It is vital that 
when you connect a sensor, you know what GPIO 
pin it is connected to. We used sticky-backed 
labels cut to the appropriate size, and stuck them 
on the board, then wrote on them with a fine- 
tipped pen (Figure 5). 


□ Cable ties are essential to 
prevent the wires resting 
in between the header 
pins and making them 
look untidy □ 


The software 

The software is written under the Pygame 
framework, mainly for the ease of sound 
generation, and is shown in the traxscript.py 
listing. The window itself has only two clickable 
words: one to load in a new script, and the other 
to reload it. The script is simply a text file (see 
Figure 6 for an example) containing instructions 
of what to do and when. Each condition should be 
on a new line, and there are only two conditions: 
‘when’ and ‘now*. The ‘when’ condition syntax is: 
when (pin Number), pin state, delay value, play 
thread number or sound. The 'now’ command 
simply plays a thread or sound immediately. 
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Figure 4 


CPIO 20 


CPIO 16 


CPIO 12 


CPIO 26 


CPIO 19 


CPIO 4 


CPIO 13 


CPIO 23 


CPIO 6 


CPIO 24 


CPIO 5 


CPIO 17 





External 
5V LED power 


Link for Internal 
5V LED power 


▲ Figure 4 Here's the fuLL wiring of the interface board. Study it carefully 



▲ Figure 5 The wires grouped and connections Labelled in the finished product 


How it works 

The software reads in the script and builds 
up a list of pins to watch and what to do when they 
are triggered. A triggering event is a change in the 
pin reading; this can be the pin going high (rises), 
going low (falls), or just changing state (changes). 
Note that a pin may appear as many times in the 
list, triggering different things on different, or the 
same, events. By building a list of the pins we want 
to monitor, we don’t waste time checking all the 
possible input pins. 


Script errors 

The beauty of using a script is that it 
documents and saves a specific layout. It does have 
its drawbacks, however. If a script contains errors, 
then the program is likely to crash. The most 
likely errors are that you specified a pin number 
that was not one of the twelve GPIO numbers the 
board uses, or you specified an FL3731 that used a 
device address not connected to the board. For an 
incorrect pin number, the one in error is printed 
out first. Adding a more rigorous file syntax¬ 
checking system could have been done, but would 
have made the code much longer. 


You now have a system that can greatly enhance a 
GraviTrax layout. Its simple scripting function can 
be a great introduction to using scripts for children. 
We do have some ideas for adding other things to a 
GraviTrax system. For now, though, feel the tug of 
gravity with added sound and lights. EU 


Figure 6 

> Language: Text 


001. 

#, GraviTrax Script example 

002. 

now. 

sound 0 

003. 

now. 

ws 7 

004. 

when 

24, rises, delay 0.2, sound 

005. 

when 

24, falls, delay 1.5, sound 

006. 

when 

4, falls, delay 0.0, fl 6 

007. 

when 

4, rises, delay 0.0, ws 4 

008. 

when 

23, falls, delay 0.0, ws 7 

009. 

now. 

fl 4 
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traxscriptpy 

> Language: Python 


001. 

#!/usr/bin/env python 

046. 

def initlOQ: 

002. 

# TnaxScnipt 

047. 

global inPins, restartRec, loadRect, 

003. 

# By Mike Cook November 2019 


stopScript 

004. 


048. 

inPins = [17, 24, 23, 4, 5, 6, 13, 19, 26, 12, 

005. 

import Neo_Thread as ws 


16, 

006. 

import FL3731_Thread as fl 

049. 

20] 

007. 

import RPi.GPIO as io 

050. 

io. setmode (io.BCM); io.setwarnings( False) 

008. 

from copy import deepcopy 

051. 

io.setup( 

009. 

from tkinter import filedialog 


inPins, io.IN, pull_up_down = io.PUDJJP) 

010. 

from tkinter import * 

052. 

restartRec = pygame. Rect((238, 7), (66,23)) 

011. 

import pygame 

053. 

loadRect = pygame. Rect((10, 7), (97,23)) 

012. 

import time 

054. 

stopScript = 0 

013. 

import sys 

055. 


014. 

import os 

056. 

def loadResourcesQ : 

015. 

root = Tk() 

057. 

global soundFX, soundNames 

016. 


058. 

soundNames = ["owl", "Breaking Glass", 

017. 

pygame. init () 

059. 

"ComputerBeepsl", "CymbalCrash", 

018. 

os.environ[ SDL_VIDEO_WINDOW_POS ] = 'center' 

060. 

"Fairydust", "Dogl", "Zoop", "Ya". 

019. 

pygame.display. set_caption ( 

061. 

"Pop", "Duck", "Gong", "Laserl", 


"GraviTrax Script player") 

062. 

"Laser2", "running", "Screech", 

020. 

screen = pygame.display. setjnode ([320,40], 0, 32) 

063. 

"SpaceRipple", "Zoop", "Dog2", 

021. 

pygame.mixer. quit () 

064. 

"DirtyWhir", "ComputerBeeps2", 

022. 

pygame.mixer. init(frequency=22050, size = -16, 

065. 

"AlienCreak2", "AlienCreakl" 

023. 

channels = 2, buffer = 512) 

066. 

] 

024. 

pygame.event. set_allowed (None) 

067. 

soundFX = [pygame.mixer. Sound("sounds/" 

025. 

pygame.event. set_allowed ([ 

068. 

+ 


pygame. KEYDOIaIN, pygame.QUIT, 


soundNames[effect] 

026. 

pygame.MOUSEBUTTONDOWN, 

069. 

+ ".wav') 

027. 

pygame.MOUSEBUTTONUP] 

070. 

for effect in 

028. 

) 


range( 

029. 

textHeight=24 ; black = (0, 0, 0) 

071. 

0, 

030. 

font = pygame. font. Font (None, texthleight) 


len(soundNames)) 

031. 

backCol = (120, 120, 120) ; lineCol = (196, 196, 0) 

072. 

] 

032. 


073. 


033. 

ws. initlOQ 

074. 

def getFileQ: 

034. 

fl. initI2C() 

075. 

global scriptName, root 

035. 


076. 

success = False 

036. 

def main() : 

077. 

while not success: 

037. 

initlOQ 

078. 

root .withdraw () 

038. 

loadResourcesQ 

079. 

scriptName = filedialog. askopenfilename( 

039. 

drawScreenQ 

080. 

initialdir = "/home/pi". 

040. 

getFileQ 

081. 

title = "Select GraviTrax script". 

041. 

loadFile(scriptName) 

082. 

filetypes = (("txt files", "*.txt"). 

042. 

setupScriptQ 

083. 

("all files", "*.*"))) 

043. 

while 1 : 

084. 

if ".txt" in scriptName : 

044. 

traxRunQ 

085. 

success = True 

045. 


086. 

else : 
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DOWNLOAD 

THE FULL CODE: 


Q magpi.cc/pibakery 


087. 

print ("not a valid text file") 

130. 

wsToPlay. append (-1) 

088. 


131. 

flToPlay. append (-1) 

089. 

def loadFile(fileName) : 

132. 

else: 

090. 

global thingsToDo 

133. 

soundFX[pram]. Dlay() 

091. 

nameF = open(fileName, "r") 

134. 

elif "ws" in val: 

092. 

thingsToDo = nameF. readlinesQ 

135. 

if not now: 

093. 

nameF. closeQ 

136. 

soundToPlay. append (-1) 

094. 


137. 

wsToPlay. append (pram) 

095. 

def setupScriptQ : 

138. 

flToPlay. append (-1) 

096. 

global pinToWatch, changeToMonitor, 

139. 

else: 


soundToPlay 

140. 

ws.startWs2812Thread(pram) 

097. 

global actionDelay, wsToPlay, flToPlay, 

141. 

elif "fl" in val: 


pendTime 

142. 

if not now: 

098. 

global nowin, lastln, trigNum, monitor. 

143. 

soundToPlay. append (-1) 


pendPlay 

144. 

wsToPlay. append ( -1) 

099. 

pinToWatch = [] 

145. 

flToPlay. append (pram) 

100. 

changeToMonitor = [] 

146. 

else: 

101. 

soundToPlay = [] 

147. 

f1. startFL3731Thread (pram) 

102. 

actionDelay = [] 

148. 

checkForEventQ 

103. 

wsToPlay = [] ; flToPlay = [] 

149. 

i i i 

104. 

print("\nloading the script"., len (thingsToDo), 

150. 

print ("pin"., pinToWatch) 

105. 

"lines") 

151. 

print("change", changeToMonitor) 

106. 

for move in range(0, len (thingsToDo)): 

152. 

print("delay", actionDelay) 

107. 

line = str(thingsToDo[move]) 

153. 

print("sound", soundToPlay) 

108. 

now = False 

154. 

print("ws animation", wsToPlay) 

109. 

for val in line.split(V )• 

155. 

print("fl animation", flToPlay) 

110. 

if "when" in val: 

156. 

. . . 

111. 

pin = int(val[-2: ]) 

157. 

monitor = len(pinToWatch) 

112. 

if not(pin in inPins) : 

158. 

nowin = [0] * monitor 

113. 

print("Pin",pin, "is not valid") 

159. 

lastln = [0] * monitor 

114. 

pinToWatch. append(pin) 

160. 

pendPlay = [0] * monitor 

115. 

elif'now" in val: 

161. 

pendTime = [0.0] * monitor 

116. 

now = True 

162. 

for i in range(0, monitor): 

117. 

elif "falls" in val and not now: 

163. 

lastln[i] = io. input(pinToWatch[i] ) 

118. 

changeToMonitor. append ( 1 ) 

164. 

print ("Current pin states", lastln) 

119. 

elif "rises" in val and not now: 

165. 


120. 

changeToMonitor. append (2) 

166. 

def traxRunQ : 

121. 

elif "changes" in val and not now: 

167. 

global nowin, lastln, stopScript 

122. 

changeToMonitor. append ( 3 ) 

168. 

while stopScript == 0 : 

123. 

elif "delay" in val and not now: 

169. 

checkForEventQ 

124. 

actionDelay. append (float (val[ -3: ])) 

170. 

for i in range(0, monitor): 

125. 

elif "sound" in val or "ws" in val or 

171. 

nowIn[i] = io.input(pinToWatch[i]) 


"fl" in val: 

172. 

if lastln[i] != nowIn[i] : 

126. 

pram = int(val[-2: ]) 

173. 

#print("Current pin states", lastln) 

127. 

if "sound" in val: 

174. 

lastln[i] = nowIn[i] 

128. 

if not now: 

175. 

tmatch = changeToMonitor[i] -1 # 

129. 

soundToPlay. append(pram) 


match 
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traxscriptpy 


> Language: Python 


176. 

if tmatch == 2: 

214. 


backCol) 

177. 

tmatch = nowIn[i] 

215. 


textRect = textSurface.get_rect() 

178. 

if changeToMoniton[i] != 0 and 

216. 


textRect.left = x # right for align right 


nowin[i] == tmatch: 

217. 


textRect.top = y 

179. 

if soundToPlay[i] != -1 : 

218. 


screen. blit (textSurface, textRect) 

180. 

pendPlay[i] = 

219. 


return textRect 


soundToPlay[i] 

220. 



181. 

if wsToPlay[i] != -1 : 

221. 

def 

handleMouseDown(pos) : # look at mouse down 

182. 

pendPlay[i] = wsToPlay[i] 

222. 


if loadRect .collidepoint(pos) : 

183. 

if flToPlay[i] != -1 : 

223. 


pygame.draw. rect(screen, lineCol, loadRect, 

184. 

pendPlay[i] = flToPlay[i] 

224. 


elif restartRec.collidepoint(pos) : 

185. 

pendTime[i] = time.time() + 

225. 


pygame.draw. rect(screen, lineCol, 


actionDelay[i] 

226. 


restartRec, 0) 

186. 

for i in range(0, monitor): # what to 

227. 


pygame.display. update( ) 


play now 

228. 



187. 

if pendTime[i] > 0.0 and time.time() 

229. 

def 

handleMouseUp(pos) : # look at mouse up 


>= pendTime[i]: 

230. 


global stopScript 

188. 

if soundToPlay[i] != -1 : 

231. 


if loadRect .collidepoint(pos) : 

189. 

soundFX[soundToPlay[i]] .playQ 

232. 


stopScript = 1 

190. 

if wsToPlay[i] != -1 : 

233. 


if restartRec.collidepoint(pos) : 

191. 


234. 


stopScript = 2 


ws. startlAls2812Thread(wsToPlay[i] ) 

235. 


drawScreenQ 

192. 

if flToPlay[i] != -1 : 

236. 



193. 

if flToPlay[i] == 99 : # stop 

237. 

def constrain(val, min_val, max_val): 


clock 

238. 


return min(max_val, max(min_val, val)) 

194. 

fl.stopCountQ 

239. 



195. 

else: 

240. 

def 

terminateQ: # close down the program 

196. 

fl.startFL3731Thread 

241. 


global root 


(flToPlay[i]) 

242. 


root.destroy 

197. 

pendTime[i] = 0.0 

243. 


pygame.mixer. quit () 

198. 

if stopScript == 1 : 

244. 


pygame. quit () # close pygame 

199. 

getFile() 

245. 


os. exit (1) 

200. 

loadFile(scriptName) 

246. 



201. 

setupScript() 

247. 

def 

checkForEventQ : # see if we need to quit 

202. 

stopScript = 0 

248. 


event = pygame.event.poll() 

203. 


249. 


if event.type == pygame.QUIT : 

204. 

def drawScreenQ : 

250. 


terminateQ 

205. 

screen. fill (backCol) 

251. 


if event.type == pygame.KEYDOWN : 

206. 

pygame.draw. rect (screen,, lineCol, loadRect, 1) 

252. 


if event.key == pygame.K_ESCAPE : 

207. 

pygame.draw. rect( screen, lineCol, restartRec, 1) 

253. 


terminateQ 

208. 

drawWords("Load script", 14, 8, black. 

254. 


if event.type == pygame.MOUSEBUTTONUP : 


backCol) 

255. 


handleMouseUp (pygame.mouse.get_pos()) 

209. 

drawWords("Restart", 244, 8, black, backCol) 

256. 


if event.type == pygame.MOUSEBUTTONDOWN : 

210. 

pygame.display. update () 

257. 


handleMouseDown(pygame.mouse.get_pos()) 

211. 


258. 



212. 

def drawWords(words, x, y, col, backCol) : 

259. 

if _ 

_name_ == '_main_* : 

213. 

textSurface = font. render (words. True, col. 

260. 


mainQ 
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Custom widgets 

with C and GTK 



Change the properties of widgets to alter how they look 


Simon 

Long 


Simon Long 
is a software 
engineer working 
for Raspberry Pi, 
responsible for 
the Raspberry 
Pi Desktop on 
both Raspbian 
and Debian. 


i rpf.io 


I n all the examples we’ve seen so far, we have 
used widgets in their default state; we’ve 
just created the widget with the gtk_<widget 
name>_new function call and used it. However, GTK 
does allow a degree of customisation of widgets by 
setting the properties for each. 

As an example, we are going to look at some of 
the properties of the basic GtkButton widget. Try 
this example: 

void main (int argc, char *argv[]) 

{ 

gtk_init (&argc, &argv); 

GtkWidget *win = gtk_window_new ( 
GTK_Ia(INDOIa(_TOPLEVEL); 

GtkWidget *btn = 

gtk_button_new_with_label ( 

"Close window"); 

g_signal_connect (btn, "clicked", 
G_CALLBACK (end_program), NULL); 
g_signal_connect (win, "delete_event", 
G_CALLBACK (end_program), NULL); 

GtkWidget *btn2 = 


An Introduction 
to C & GUI 
Programming 

For further tutorials on how to start coding 
in C and creating GUIs with GTK, take a 
look at our new book, An Introduction to 
C & GUI Programming. Its 156 pages are 
packed with all the information you need 
to get started - no previous experience of 
C or GTK is required! 
magpi.cc/GUIbook 


A ^INTRODUCTION TO 

C&GUI 

PROGRAMMING 


gtk_button_new_with_label ( 

"My button"); 

g_object_set (G_0B1ECT (btn2), "relief", 
GTK_RELIEF_NONE, NULL); 

GtkWidget *box = gtk_vbox_new (FALSE, 5); 

gtk_box_pack_start (GTK_BOX (box), btn2, 
TRUE, TRUE, 0); 

gtk_box_pack_start (GTK_BOX (box), btn, 
TRUE, TRUE, 0); 

gtk_container_add (GTK_CONTAINER (win), 
box); 

gtk_widget_show_all (win); 

gtkjnain (); 


} 


This is familiar code from previous examples, but 
the highlighted line is new. 

g_object_set takes as arguments the name of 
a widget, followed by a NULL-terminated list of 
property names and property values. In this case, 
we are setting the relief property of the GtkButton 
btn2 to GTK_RELIEF_N0NE (see Figure 1). 


Figure 1 


- □ X 




My button 




Close window 


Figure l A GtkButton with the relief property 
set to GTK RELIEF NONE 


60 magpi.cc | Custom widgets with C and GTK 

















TUTORIAL I MatfPi 


The belief of a GtkButton controls how the 
border looks. The borders of some GTK widgets 
have a degree of shading applied around them 
to provide a 3D appearance - by default, a 
GtkButton has this shading applied, which makes 
the button appear to stand out slightly from 
the window background. By setting the relief to 
gtk_relief_none, this 3D shading is removed - if 
you run the program above, you should be able to 
clearly see the difference between the two buttons 
on the window. (You can use the TAB key to move 
the dotted outline between the buttons to show the 
difference more clearly.) 

Here’s another example. Remove the setting of 
the relief property, and change the name of the 
button by adding an underscore: 


GtkWidget *btn2 = 

gtk_button_new_with_label ( 
"My_button"); 


You should end up with a button that looks like that 

in Figure 2. 

If you now set the use-underline property: 

g_object_set (G_0B1ECT (btn2), 

"use-underline", TRUE, NULL); 

.. .the underscore will vanish, but will reappear 

□ The borders of some GTK 
widgets have shading 
applied around them to 
provide a 3D appearance □ 

under the ( b’ of button’ if you hold down the ALT 
key on the keyboard (Figure 3, overleaf). 

All widgets have properties that can be set 
like this. As another example, try replacing the 
GtkButton with a GtkLabel: 


GtkWidget *lbl = gtk_label_new 

( 

"My label"); 


.. .and then setting the angle property of the label to 

45 degrees: 


g_object_set (G_0B1ECT (lbl). 

"angle". 

45.0, NULL); 



(Note that it is important to enter the angle as 


Figure 2 

_ □ 



Close window 



... . . . . ▲ Figure 2 A GtkButton 

45.0, rather than just as 45 - the value expected is wit h an underline 

a floating-point number, and adding the .0 to the in the LabeL and 

the use-underLine 

end of the value ensures that the compiler treats it property set to false 

as such.) 

You should end up with a window which looks 
like this, with the label text at a 45 degree angle to 
the horizontal (Figure 4, overleaf). 

In many cases, widgets also have dedicated 
functions to set each property which can be used 
instead of the generic g_object_set function 
(in the examples above, gtk_button_set_relief, 
gtk_button_set_use_underline, and 
gtk_label_set_angle, respectively). The advantage 
of g_object_set is that it can be used to set 
multiple properties in one line, which can shorten 
your code significantly. 

The GTK online documentation page for each 
widget lists all the properties and dedicated 
functions to set their values. For the two examples 
above, this can be found at magpi.cc/GtkButton 
and magpi.cc/GtkLabel - it’s worth having a look 
through the options for any widget you want to 
use. (These pages are also a good way of finding out 
what signals are generated by a widget when a user 
interacts with it.) 

An introduction to themes 

The other way that GTK widgets can be customised 
is by the use of a theme. A theme affects the 
appearance of every instance of a widget in 
every GTK application, rather than changing the 
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appearance of individual widgets one at a time. 
There is a selection of themes installed in Raspbian 
(and in most other Linux desktop distributions), in 
the directory /usr/share/themes. 

This directory contains a number of named 
folders, each of which is a theme for either GTK or 
other themeable applications. If a named folder 
contains a subfolder named gtk-2.0, then the name 
of that folder is also a valid GTK 2 theme name. 

Which of the themes is currently used by GTK 
applications is usually controlled by the xsettings 
daemon , a process which runs in the background 
and provides configuration information to all 
desktop applications. On Raspbian, to change 
which theme is set in the daemon, you need to 
change a value in a configuration file. 

□ Which theme is currently 
used by GTK applications 
is usually controlled by the 
xsettings daemon □ 

To do this, check to see if there is a file called 

desktop.conf in the directory -/.config/lxsession/ 
LXDE-pi. If there isn’t, create one by copying the 
file /etc/xdg/lxsession/LXDE-pi/desktop.conf into 
that directory. 

If you then look in the desktop.conf file with 
a text editor, there is a section headed [GTK]. 
Somewhere under this heading is a line starting 
sNet/Themel\lame=, which by default on Raspbian 
is set to PiX. If you change Pix in this line to the 



► Figure 3 The same 
GtkButton, but with 
use-underline set 
to TRUE 



Close window 





Close window 


▲ Figure 4 A GtkLabeL with the angle property set to 45.0 

name of another GTK +2 theme (any directory 
in /usr/share/themes which includes a gtk-2.0 
subdirectory), the theme in use will automatically 
update and you should see every GTK application 
running redraw with the new theme. 

Creating a theme is not for the faint¬ 
hearted, but if you are interested, look inside 
one of the gtk-2.0 subfolders in the directory 
/usr/share/themes 

The theme itself is in a file in this folder named 
gtkrc; there may also be a number of other 
subfolders containing graphical elements and 
other resources used by the theme. 

The gtkrc file is a plain text document which 
can be opened in your editor of choice. Most of 
them contain a number of style definitions, which 
consist of the word style followed by a number of 
lines contained within curly brackets. At the end of 
the file are lines which associate widgets with the 
styles previously defined. 

To change the appearance of a widget, find it 
in the list of associations at the end of the file, 
and note which style applies to it. Then locate 
the definition of that style within the file and try 
changing some of the parameters to see what 
happens. Do back up the original gtkrc file before 
you do this - or even better, copy the whole theme 
folder and give it a new name of your choice; set 
the ThemeName in desktop.conf to the name of 
your new theme, and create your own theme by 
modifying an existing one! E 3 
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■ Get game design tips and 
tricks from the masters 

■ Explore the code listings and 
find out how they work 

■ Download and play game 
examples by Eben Upton 

■ Learn how to code your own 
games with Pygame Zero 


This stunning 224-page hardback book not only tells 
the stories of some of the seminal video games of the 
1970s and 1980s, but shows you how to create your 
own games inspired by them using Python and Pygame 
Zero, following examples programmed by Raspberry Pi 

founder Eben Upton. 


Available now: magpi.cc/store 
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Design a 3D printer 

pendant with BlocksCAD 



Dr Tracy 
Gardner 


Tracy is a computer 
scientist who spent 
ten years working 
as a software 
architect at IBM. 

She now writes 
educational projects 
for the Raspberry Pi 
Foundation. 

rpf.io/projects 


You'll Need 


> Raspberry Pi 4 

> BlocksCAD 3 D 

blockscad3d.com 

> 3 D printer 

(magpi.cc/69) 


► Use a translate block 
to move the first 
hoop off centre 


Use BlocksCAD to design a 3D pendant based on the Flower of Life pattern 


B locksCAD is a 3D model editor that you use 
in a web browser, and it runs on Raspberry 

Pi. You drag and drop code blocks to design 
3D models that can be exported for 3D printing. 

In this project, you will use BlocksCAD to design 
a 3D pendant. The pendant uses a geometric 
design based on the ‘Flower of Life’, a design 
which is often found in historical art. 

If you have access to a 3D printer, then you can 
print your pendant. The pendant is small and 
only uses a little bit of filament, and it is quick to 
3D-print. There’s a hoop on top of the pendant 
so that you can put it on a necklace or cord. The 
pendant has a diameter of 40 mm, plus the hoop 
for hanging. It is 2 mm thick, so it will 3D-print 
quite quickly. 

After this project, you’ll also be able to code 
your own design and create a custom pendant. 


Create a hoop 

This project can be completed in a web 
browser using BlocksCAD (bl0ckscad3d.com). 
Open Chromium and enter the BlocksCAD editor 
URL: blockscad3d.com/editor 

The design uses six interlocking hoops in the 
centre, and a larger hoop around the outside. As 
mentioned, the pendant is 40 mm wide, plus the 
hoop for hanging, and is 2 mm thick. 

Click 3D Shapes and drag a cylinder block to 
the project. Create a cylinder with a radius of 12, 



▲ The design is influenced by the Flower of Life pattern. If you 
like, you could research the Flower of Life and see if you can 
create a design based on the Seed of Life pattern 


and a height of 2 (the unit here is millimetres). 
Cylinders are automatically centred along the 
X and Y axes. Select ‘not centered’ so that the 
pendant sits on the surface. (This means that the 
Z axis value is larger than 0.) 

Click on the Render button after each change to 
your code to see the results. 


Add more hoops 

Now, drag a difference block from Set Ops to 
encase the cylinder. Add another cylinder block in 
the bottom space, and this time give it a radius of 11. 
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The preview window displays what the 
3D-printed object will look like. Click 
and drag to rotate the image around 


i ■ 

Lotfn 


This will remove a smaller cylinder from the centre. 
This creates a hoop. Click Render again to see it. 

If you like, you can click on the coloured square 
to change the colour used in the viewer. This does 
not affect the colour of your pendant, as that 
depends on the colour of the filament that you use. 

The design uses six intersecting hoops, and each 
hoop is moved out from the centre and rotated a 
different number of degrees. 

In the final design, there is no central hoop: the 
hoops are all moved out from the centre. 

Drag a translate block (from Transforms) around 
your code, and set x and y to 5. This moves the first 
hoop into position. 


□ The design uses six 
intersecting hoops, each 
moved out from the centre 
and rotated □ 

Look at the code and make sure you understand 
how it works. The finished design has six hoops 
rather than three. In the count block, set i from 1 
to 6, and set the Z rotation to 60, so it creates six 
equally spaced hoops. 


Centre the hoop 

Now the hoop is a little off-centre. You need 
multiple copies of this hoop, rotated around the 
centre. First, create three equally spaced hoops. 

Add a count Loops block to create three hoops. 

To space the hoops, add a rotate Transforms block 
between the count loop and the translate block. 

In the count block, set the i variable from 1 to 3. 
You’ll need to insert an arithmetic block from Math 
and a variable (i) block from Variables into the Z 
field of the rotate block. 

The rotation moves each hoop by 120 x i degrees, 
so that the three hoops are distributed equally 
around the 360 degrees of a circle (360 / 3 = 120). 


03 


Add a border 

Next, add a border around the edge of the 
design. Create a centred hoop that touches the 
edges of the design. You can either do the maths to 
work out what the radius of the circle needs to be, 
or you can just create a circle and change the radius 
until it works. Either approach is fine! 


T By using a count 
Loop and a rotate 
bLock, you can 
quickly create 
multiple hoops 
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► You can 3D-print the 
pendant in any colour 
filament you like 


Top Tip 4 


Bigger hoops 


The code adds a 
small hoop that 
can be used with 
elastic necklace 
thread. If you have 
a bigger cord or 
chain, you can 
adapt the code 
to create a bigger 
hanging hoop. 


► The outer hoop 
shouLd just touch 
the edges of the 
inner ones 



Encase your code with a union block from Set 
Ops, to join the border to the other hoops. 

Add a difference block to the plus section of 
union, and two cylinder blocks to make the hoop. 

The six hoops each have a radius of 12 mm, so 
the border cylinder that you are making needs to be 
bigger than that. You could try setting the radius 
to 24 mm. 

To make a hoop, the radius of the second 
cylinder in the difference block needs to be imm 
smaller than the radius of the first cylinder. 

Adjust the size of the cylinders until the border 
hoop just touches the outer edges of the six 
inner hoops. 

The radius should be around 20. (As mentioned 
in the introduction, the finished pendant will be 
40mm in diameter.) 



Work it out 

You could also use maths to work out 
the diameter. The diameter of each inner hoop 
is 24 mm. If the hoops met at the centre of the 
pendant, the border hoop would need to have a 
radius of 24 mm. But the inner hoops overlap, as 
they are translated 5 mm along the X and Y axes. 

This removes a section from the radius. This 
section is on the arc, 5 mm from the origin, so we 
need to remove 5 mm from 24 mm. Thus the inner 
radius of the border hoop should be 19 mm. 

Maths is really useful when you need to be 
accurate. But it’s fine to just change things until 
you get the result you need. 


Add a hanging hoop 

Now, add a small hanging hoop through 
which you can thread a cord to make a necklace. 
Click the [+] on the union block to add another 
section to add the new hoop. 

At the moment, the position of the hanging 
hoop isn’t very visually pleasing. 



▲ Adding blocks to create a small hanging hoop for 
the pendant's cord 
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Add a rotate block to move the inner hoops so 
that the hanging hoop is centred over one of the 
gaps between them. 


Experiment with shapes 

Experiment and change some values in your 
pendant. For example, change the number of hoops, 
or the rotation. You could also try to use cuboids 
(cubes) instead of cylinders to create a pattern. 


□ Very carefully remove the 
3D print from the print bed, 
The pendant is thin, so it's 
quite delicate □ 


Top Tip A 


Issue 69 


Learn all about 
3 D printing and 
setting up a low- 
cost 3 D printer in 
issue 69 of The 
Mag Pi magazine 
(magpi.cc/69). 


Export to STL 

BlocksCAD 3D can export an STL file for 
3D printing. Render your model and then click on 
Generate STL. Remember where you save the STL 
file. Now 3D-print your pendant using a filament 
of the colour of your choice. Very carefully remove 
the 3D print from the print bed. The pendant is 
thin, so it’s quite delicate. 

You might need to remove small strands of 
filament (especially from the hanging hoop) to tidy 
up the print. 

Thread the pendant on a chain or cord. If you 
want to use a thicker cord or necklace, then you can 
adjust the design to have a larger hanging hoop. ED 



▲ Try adjusting the design and using different shapes 





Flower of 
life pendant 


> Language: BlocksCAD 


DOWNLOAD 
THE FULL CODE: 


magpi.cc/ 
blockscad-pendant 


(hull ■) 
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I FEATURE 


Raspberry Pi 


Kit & Gadget 
Guide 


Do more with your Raspberry Pi with these amazing 
add-ons! Compiled by Wes Archer 



e all know that Santa loves a mince 
pie, but did you know that he is often 
partial to leaving Raspberry Pi boards 
under the tree of those on his ‘nice* list? Well, 
if you got a Raspberry Pi for Christmas, then you 
may want to know about some of the awesome 
accessories you can get for it to really get the 
most out of your brand new computer. With so 
many cool accessories available, it can be a 
minefield knowing which ones to go 
for, so let us help you make up 
your own mind based on 
some ideas of ours. 


Cases 

Essential add-ons 

Cool HATs 

Electronic starter kits 

Gaming kits 

Gaming accessories 

Robot building kits 


magpi.cc 
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Raspberry Pi cases 


W e think Raspberry Pi looks cool as it 

is, but a case is a highly recommended 
accessory. Not only will it protect 
your Raspberry Pi and the delicate circuitry, it 
can also enhance the way some of the additional 
accessories work when used in combination. 


Official Raspberry Pi 4 Case 


If you want an affordable, reliable, and hackable 
case, then you cannot go wrong with the 
official Raspberry Pi case. Available in red and 
white or black and grey, this case will house 
your Raspberry Pi with ease. 

If you’re feeling 
adventurous, you 
can also hack the 
case to fit a small fan 
for cooling! 

£5 I magpi.cc/case 




The SecurePi case looks very futuristic, especially 
with those angles! This case provides protective 
covers for your microSD card, USB, Ethernet and 
micro HDMI ports, and also has venting which 
is ideal for providing airflow for keeping your 
Raspberry Pi cool. It has space for the PoE HAT or 
Fan SHIM too! 

£10 I magpi.cc/securepi 


M Protect your 
ports and your 
Raspberry Pi with the 
SecurePi case 



Raspberry Pi 4 is 
the most powerful 
Raspberry Pi yet. 
ALL this horsepower 
means it can get 
a bit hot, though. 
The most effective 


Pibow Coupe 4 


The Pibow by Raspberry Pi veterans Pimoroni is 
a classic Raspberry Pi case. Designed to be quick, 
easy, and cheap, the Pibow is made up of multiple 
layers of laser-cut acrylic. The Coupe version is 
slimmed down and gives easy access to Raspberry 
Pi’s GPIO and other inputs. 

£8 I magpi.cc/pibow 



▼ Assembling the Pibow’s 
rainbow layers is fun 
and it looks great 


Aluminium Raspberry 
Pi 4 Case 


Aluminium is a 
great, lightweight 
metal that is also 
strong and is an ideal 
choice for a Raspberry Pi 
case because of these properties. 

This case looks great, especially if used as part 
of a 4K home media setup. With the holes, the 
cooling potential is also fantastic. 

£10 I magpi.cc/aluminium 



cooling method 
is active cooling, 
which is typically 
accomplished with a 
fan. The Fan SHIM is 
perfect as it is Low- 
profile, inexpensive 
and allows you 
to use the GPIO 
pins for other 
accessories. 



Anidees Raspberry Pi 4 Case 


Made of aluminium, the Anidees 
case provides ample 
protection for your precious M 
Raspberry Pi. It comes 
in two colours - silver or 
black - and has an extra tall 
version to accommodate 
some HATs too. Oh, and it 
has an clear lid so you can see 
your Raspberry Pi in all its glory! 
£37 I magpi.cc/anidees 






▼ We love the clear 
acrylic Lid that allows 
you to see inside 


r 
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Essential add-ons 


Some accessories ore essential for any Raspberry Pi fans, These accessories 
will be useful in pretty much every project, so take a look below 



▲ The official keyboard 
doubles as a USB hub 
with its three extra ports 


Raspberry Pi Keyboard 


You’ll need a keyboard in pretty much every 
Raspberry Pi project going. The Raspberry Pi 
Keyboard comes in a variety of layout options, and 
is available in two colour schemes. Not only does 
the keyboard connect via USB, it also has three 
additional USB 2.0 ports to free up ports on your 
Raspberry Pi. 

£16 I magpi.cc/keyboard 


Rii i8+ Mini Wireless Keyboard 


If you want to go one step further, why not 
combine the keyboard and mouse into one and 
make it wireless while you’re at it? With the Rii i8 
Mini Wireless Keyboard with Touchpad, you can do 
just that! The supplied USB wireless dongle plugs 
into your Raspberry Pi and connects automatically. 
£18 I magpi.cc/wirelesskeys 



BEEHSfl 

USB microSD 
card adapter 

If you're reguLarly 
writing microSD 
card images for your 
Raspberry Pi, a USB 
microSD card adapter 
is a great tool to have, 
especially if your 
computer doesn't 
have an SD card slot! 

magpi.cc/usbsd 


□ The Raspberry Pi Keyboard 
comes in a variety of 
layout options, and two 
colour schemes □ 



Something 
simple, yet 
extremely 
effective and 
an essential 
accessory for any 
Raspberry Pi project, 
allowing you to navigate through 
any graphical user interface. The Raspberry Pi 
Mouse, when combined with the Raspberry Pi 
Keyboard, can be powered from the keyboard’s 
USB hub, keeping those precious ports free on 
your Raspberry Pi itself. 

£7 I magpi.cc/mouse 



Retro Cube Bluetooth Speaker 


Why use a USB port or cable when you can use 
Bluetooth to keep things wireless? This little 
speaker, by retro gamepad specialists 8bitdo, 
is a fantastic little Bluetooth 
speaker. Styled like a 
retro console controller, 
this rechargeable 
speaker provides up to 
eight hours play after 
one hour of charging. 

£18 I magpi.cc/speaker 



4 Port USB Hub 


Whilst Raspberry Pi has four USB ports, they can 
be used up quickly depending on how you 
are using it. Having a dedicated USB hub 
is always handy, particularly if you 
have a Raspberry Pi Zero. This 
four-port hub has both USB 
and micro USB connectors, so a 
works on any Raspberry Pi! 

£8 I magpi.cc/usbhub 


With both standard 
USB-A and micro 
USB ports, this hub 
has you covered 
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Cool HATs 




There are hundreds of HATs available for Raspberry Pi. As they 
are so easy to connect and set up, they are a perfect accessory 


▲ As used on the ISS. 
the Sense HAT is 
packed with sensors 
and features 


Sense HAT 


If you want something 
a little more ( out of 
this world’, then the 
Sense HAT is a perfect choice. 

Used on the International Space Station 
as part of AstroPi, the Sense HAT monitors 
temperature, humidity, pressure, and orientation. 
It also has an 8x8 LED matrix on top for additional 
display purposes. 

£30 I magpi.cc/sensehat 


Enviro 


The Enviro is a fantastic piece of kit. It allows 
you to monitor a number of environmental 
factors, such as temperature, light, and sound. 
The fully-featured Enviro + Air Quality version 
also includes a gas sensor. Simply connect to 
your Raspberry Pi, install the code, and you’ll 
have your very own monitoring station. 

£28 I magpi.cc/enviro 


Display-O-Tron HAT 


The Display-O-Tron HAT is a fantastic little 
screen, backlit with controllable RGB LEDs, has six 
capacitive touch buttons, and also features a small 
LED bar graph! If you want to run your Raspberry Pi 
‘headless’ (i.e. without a screen connected), then 
the Display-O-Tron HAT is ideal. 

£23 I magpi.cc/displayotron 



▼ IdeaLfor 
displaying 
data without 
a monitor 


TV HAT 


TV on a Raspberry Pi? Yes, that’s right! With 
the TV HAT and a bit of configuration, you can 
set your Raspberry Pi to receive 
terrestrial television 
It is even possible to 
record TV shows so 
that you can watch 
them back at your 
leisure too! 

£20 I magpi.cc/tvhat 



pHAT DAC 


A DAC (digital-to-analogue converter) is a 
must for anybody who takes listening to music 
seriously. The quality of your music is much 
better when a DAC is used, and the pHAT DAC is 
a great little accessory that you can use to play 
music to your heart’s content. 

£13 I magpi.cc/phatdac 



BSESfl 

Resistor lead 
bending tool 

Prototyping is 
essential, and this 
handy tool makes 
it easier to bend 
those resistors into 
breadboard- 
friendly form. 

magpi.cc/resistorbend 


\ 
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Electronic starter kits 


A Raspberry Pi can do more than play retro games or videos. Thanks to 
the GPIO pins, you can interact with a variety of sensors and devices 



Jam HAT (LED & 
Buzzer Board) ■ 


If you’re not that 
good at soldering 
and want something 
that is pre-assembled 
in a HAT form, then 
the Jam HAT is a great 
alternative. With LEDs, 
buttons and a buzzer, you 
can use the code examples provided to create your 
own unique projects, all for under a tenner! 

£7 I magpi.cc/jamhat 









Prototyping is a great way to start 
experimenting with sensors, 

LEDs, buzzers, and 
everything else that can be 
connected to a Raspberry 
Pi. The Camjam EduKit 
contains a breadboard, an ^ 

essential tool that allows you 
to make your own prototype 
circuits without soldering a thing, 
as well as other essential components. 

£5 I magpi.cc/edukit 


CamJam EduKit 


Gaming kits 


Feeling adventurous? Have a go at building your own Raspberry Pi-powered gaming setup 


TinyPi Pro 


What good is a portable games 
console unless it fits in the smallest 
of pockets? Enter the TinyPi Pro 
- a do-it-yourself kit that is a 
small but perfectly formed games 
console. These sell like hot cakes, 
but are a real gem if you can get a hold of one, 
and you’ll learn lots during the build. 

£90 I magpi.cc/tinypipro 



BASIC Monster Arcade 
Controller Kit 


If the full Picade kit is a bit too lavish for you, 
then the Arcade Controller Kit by Monster is a 
great alternative. With this kit, you’ll build an 
arcade stick that houses your 
Raspberry Pi, which can be 
connected to your TV for a 
more portable setup. 

£60 I magpi.cc/monsterbasic 



PiGRRL 2.0 kit 


If you fancy 3D-printing your own case (designs 
are included) and putting your build skills to the 
test, then consider the PiGRRL 2.0 kit. You’ll need 
to supply the Raspberry Pi and the case, but you’ll 
have a great time putting it all together and testing 
it out when complete. 

£56 I magpi.cc/pigrll2 



Picade 


When it comes to arcade kits, 
Pimoroni’s Picade is king, and for 
very good reason! The kit is expertly 
crafted and has been refined since 
it was initially launched after a 
successful Kickstarter campaign. 

It comes in two options - with an 
8 -inch or 10-inch display - and 
with detailed step-by-step build 
instructions and videos. 

£150 to £195 I magpi.cc/picade 



72 | magpi.cc | Raspberry Pi Kit & Gadget Guide 


















FEATURE I 


Gaming accessories 


Raspberry Pi is an excellent choice for emulating and ploying retro games. 
But what accessories should you consider? 



SN30 Pro+ Bluetooth Gamepad 


There are so many controllers to choose from, 
but 8BitDo’s wireless gamepads are an excellent 
choice. The quality and looks of these controllers 
really add that ‘wow’ factor to any retro gaming 
build. This one has analogue thumbsticks and 
comes in a choice of three colours. 

£45 I magpi.cc/sn30pro 


MEGAPi Case 


If you’re going to build a retro gaming system, 
what better than this fantastic scaled version of 
the Sega Mega Drive from RetroFlag? Their cases 
are spectacularly well designed and this one is the 
perfect combination of nostalgia and functionality, 
especially with the programmable shutdown 
buttons and cooling fan. 

£25 I magpi.cc/megapi 



GPi Case 


Why not go one step further and make 
a portable retro gaming system? The 
GPi Case is a beautiful replica of a retro 
handheld console, and the attention to 
detail is breathtaking. A Raspberry Pi Zero 
(not supplied) is housed in a detachable 
cartridge and it even runs off regular AA 
batteries for gaming on-the-go. 

£60 I magpi.cc/gpicase 

□ A Raspberry Pi 
Zero is housed 
in a detachable 
cartridge □ 



FIETFOHLRQ GPI CASE 






Classic USB Games Controller 


If you want functionality without breaking the 
bank, then the classic USB game controller 
is an excellent choice. Modelled on a classic 
controller, this connects to your Raspberry Pi via 
USB - and a generous cable length means you 
don’t need to sit too close to your TV to play! 

£8 I magpi.cc/usbcontroller 


A Create your own 
portable retro 
system with this 
stunning case 


BSESB 



Micro USB to 
USB-C adapter 

This Little adapter lets 
you use your existing 
micro USB power 
supplies with the new- 
style USB-C ports on 
Raspberry Pi 4. 

magpi.cc/microusbc 


M An extra-Long 1.8 m 
cable gives this 
classic controller 
the edge 
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Robot building kits 


R2-02 or C-3PQ? Or are you more of a BB-8 fan? No matter your 
favourite, you can always build your own with one of these kits 



If you are after a budget kit, this Camjam one 
is a great introduction to robotics. You^I need 
to supply your own Raspberry Pi and chassis 
(something to attach the kit to), but it’s a great 
way of getting into the world of robotics before 
delving into something a little more complex. 
£18 I magpi.cc/edukit3 


MeArm 


These types of robots are used in manufacturing and 
engineering plants - well, maybe not Raspberry Pi 
versions, but the same style. With the MeArm kit, 
you can build a robotic arm that is controlled using 
the two supplied thumbsticks (or with code). An 
ideal option for a budding robotics engineer! 

£70 I magpi.cc/mearm 




MotoZero 

A motor driver 
capable of powering 
four motors, this 
board is a great and 
affordabLe choice for 
any robotic build. 

magpi.cc/motozero 


Picade X HAT 
USB-C 

If you fancy building 
your own arcade 
setup without a 
kit, this add-on 
makes controller 
configuration a 
breeze. It works with 
the Pi 4 too! 


STS-Pi 


The STS-Pi is a great little robot kit that gives 
you the bare bones to build a two-wheeled roving 
robot. YouTl need to supply a Raspberry Pi, Camera 
Module, and motor driver (such as the Explorer 
pHAT), but youTl learn the basics of robotics with 
this nifty kit. 

£23 I magpi.cc/stspi 





▼ One of the most 
rugged robots 
around, it's a 
real monster! 


MonsterBorg 


The title says it all here: this is the ultimate 
Raspberry Pi robot and is designed to withstand 
some punishment. The chassis is rugged and 
made of aluminium, and the wheels make it a 
great off-road choice, especially with the three 
hours run time. Oh, and it runs any side up, too! 
£210 I magpi.cc/monsterborg 


magpi.cc/xhat 


Picade 
Plasma kit 

Want flashy LED 
arcade buttons 
instead of pLain ones? 
This kit adds aLLthe 
jazziness you'll need! It 
comes in six- or ten- 
button options. 

magpi.cc/picadeplasma 
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SPECS 


BUILT-IN 

SENSORS: 

BME280 

temperature/ 

pressure/ 

humidity, 

LTR559 

Light/proximity, 

SPH0645LM4H-B 

noise 

DISPLAY: 

0.96-inch 
colour LCD 
(160x80) 

DIMENSIONS: 

65x30x8.5 mm 


Verdict 


Lacks the gas 
sensor of the 
Enviro + Air 
Quality board, but 
features the same 
mini LCD screen 
to display your 
environmental 
data without 
a monitor. 

8/10 


► Pimoroni ► magpi.cc/enviro ► £28/$30 


An environment-sensing board with a mini 
LCD screen to display data. By Phil King 



® 000000 oqo 


A The rear of the board, showing the pre-soLdered 
female GPIO header 


esigned for indoor monitoring, the Enviro 
board enables you to measure temperature, 
pressure, humidity, light, and noise levels. 

While it lacks the gas sensor, ADC, and particular 
matter sensor connector of the Enviro + Air Quality 
version (reviewed in TheMagPi #83, magpi.cc/83), 
it retains the cool mini LCD colour screen to display 
data - ideal when using your Raspberry Pi in a 
headless setup, without a monitor. 

It also features the same slimline pHAT form 
factor to match the size of a Raspberry Pi Zero, 
although it can be used with any Raspberry 
Pi model. 

Sensing the world 

The Enviro’s BME280 weather sensor monitors 
temperature, barometric pressure, and humidity. 
As on the Enviro +, this has been positioned at the 
left edge of the board, away from Raspberry Pi’s 
CPU, and there’s even a little smile-shaped slot 
around it to help reduce heat radiated through 
the board. Even so, you’ll need to adjust its 
temperature reading for accuracy (by measuring 
that of the CPU itself and deducting a factor of it). 

A smartphone-style LTR-559 light and proximity 
sensor detects the ambient light level and also 
proves handy as a substitute for a push-button 
when you put your finger on it. The board’s tiny 
MEMs microphone measures sound levels, useful 
for monitoring noise pollution, and can also be 
used to record audio. 


At the time of writing, most of the code 
examples provided with the Python library 
(magpi.cc/enviroGH) are aimed at the Enviro + Air 
Quality board. However, it’s easy to edit the code 
for missing sensors from the all-in-one example 
to get it showing rolling graphs for temperature, 
pressure, humidity, and light level on the LCD. 
There are also a couple of examples that make use 
of the mic to plot noise levels and frequencies. 

If you don’t need to test air quality and just want 
a simple environmental sensor with a built-in 
display, the Enviro is ideal. The light sensor could 
also come in handy for use in IoT setups, such as to 
trigger your lights to come on when the light level 
falls below a certain level. 

If you also require motion/direction sensing, 
the original Enviro pHAT is still available (albeit 
without the mini LCD). EH 
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SmartiPi Touch 2 

► The Pi Hut ►magpi.cc/smartipi2 ► £24/$32 


A very smart-looking case for the discerning touchscreen user, 
Rob Zwetsloot puts one together for a test 


W e feel like we slightly overlooked the 
original SmartiPi case, so we’re happy 
to rectify this with the brand new 
SmartiPi Touch 2. 

This case is designed to work with the 7-inch 
official Raspberry Pi touchscreen, effectively 
turning a Raspberry Pi into a (bulky) tablet or fixed 
monitor. As there’s no real room for rechargeable 
batteries as standard, it works better in a more 
fixed environment. 

□ You can choose little 
feet for the display, or a 
foldable stand □ 


Verdict 


A great case if you 
need a stationary 
tablet, although 
making it mobile 
might be a Little 
more tricky. 

8/10 



A It Looks sleek and compact from the front 


One of the unique features of the SmartiPi is 
the interchangeable faceplates on the front of the 
case. As well as allowing for a Raspberry Pi Camera 
Module to be mounted inside the case, it enables 
you to add a Lego-compatible plate. It’s not large, 
so you can’t do much with it, but it’s a very neat 
addition nonetheless. 

Smart build 

Construction is extremely easy, just requiring 
you poke some ribbon cables in the right place 
and fasten and tighten some screws to make sure 
everything is mounted properly. You can choose 
little feet for the display, or a foldable stand so 
you can angle the screen - both are easy to install 
and even replace. There’s also a little case fan and 
vented rear panel to keep your Raspberry Pi cool. 

It’s extremely well thought out, and a very handy 
case if you need a compact ‘Raspberry Pi with 
screen’ solution that just looks nice. ED 



A The additional case fan and vents can be handy for intensive loads 
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10 Best: 

Advanced 
kits and 
projects 

Take your making skills to the next level 
with these advanced kits and projects 

S o, you’ve looked over the tips and tools 

(page 26), got yourself some cool accessories 
(page 68), and now you’re looking for a 
challenge. Something fun to build. A big new year 
project. We have some great ideas for you... EH 



a DiddyBorg 


A robotic beast 

A serious robot the DiddyBorg is diddy in name only and a true 
Raspberry Pi automated monster. Program it, remote-control it, or 
just have it sitting pretty in your workshop. Your choice. 

£220/$299 I magpi.cc/diddyborg 



DIY handheld gaming 

We’ve covered this project in a previous issue of The MagPi, but this project 
deserves mentioning again: with some 3D-printed parts, and some ingenious 
Adafruit PCB parts, you too can make a handheld console. 

£56 / $60 I magpi.cc/pigrrl2 


▼ Arcade machine 


Retro-cool at home 

This big build by Bob CLagett is 
incredibly thorough, and shows 
you how to build a wooden arcade 
cabinet from scratch, complete with 
Lights and cooLart. 


magpi.cc/arcade 




a Pinball table 


High score mania 

If an arcade machine is a bit too 
new for you, how about something a 
bit more classic and physical Like a 
pinball table? This one repurposes an 
old bed. 

magpi.cc/78 
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► Magic mirror 


Raspberry Pi classic 

This kind of project is a classic among 
the community, especially as the 
mirror software part is so easily done. 
Building a frame is quite fun and a 
great first-time carpentry project. 

magicmirror.builders 




« Laptop 


Take Raspberry Pi 
anywhere 

This tiny laptop project allows you 
to bring your Raspberry Pi with you 
wherever you want to go, and do 
some work while you’re there. 

magpi.cc/74 


Home assistant 


Voice-controlled computer 

A number of big voice services are available on Raspberry Pi. Alexa is one of the 
easiest to get onto Raspberry Pi, thanks to the excellent AlexaPi software. 

magpi.cc/alexapi 



Machine Stale: Printing 
File CuteOcto.gco 
Timclapsc: Timed (2 sec) 
Filament (Tool 0): 2.22m 
Approx Total Print Time 00 m 

Print Time Left: 44 minutes 


Webcam cover - Part la.gcodc 


Temperature Control GCodc Viewer Terminal 



Hotend 209.0 8 C 


3D printer controller 


Futuristic plastic printing 

Have a new 3D printer? How about interfacing it with Raspberry Pi 
using the amazing OctoPrint? It’s especially helpful if you think of 
something cool to print while on the go. 

octoprint.org 



a Smart CCTV system 


Recognise your visitors 

CCTV cameras with Raspberry Pi are not too difficult to put 
together. We like this project as it uses computer vision and face 
detection to recognise known people as well. 

magpi.cc/smartCCTV 


LEARN TO PROGRAM! 


Scan your friends 

This big project is great for showing off at your local Raspberry Jam or maker 
event. It takes a Lot of Raspberry Pi boards and cameras to create the project, 
but it does capture impressive 3D scans. 

magpi.cc/3dscanner 


Got the tools and the skills to raise a barn and then 
some, but lacking the ability to print ‘Hello World’? 
Take a look at our books on controlling electronics 
with Python and GPIO Zero (magpi.cc/GPIOZbook) 
and learning C (magpi.cc/CGUI). 
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Learn R with Raspberry Pi 


Discover this statistical language and explore data science. By Lucy Hattersley 


I DataCamp 



DataCamp 


Price: 

FREE (or $568 per year) 

datacamp.com 


R is a language intrinsically 
linked to data and statistical 
analysis. Popular with scientists 
and number crunchers, it has 
fans around the globe. 

If you’ve spent a lot of time in 
Python and other programming 
languages, some of the 
features of R are confusing at 
first. Assignment operators 
are arrows, and lists are one- 
indexed (with the first item 
starting at position one, rather 
than zero). All of this is designed 
to make working with large 
datasets more friendly. 

DataCamp is a great learning 
resource for R, Python, and SQL. 



It uses a web-based code editor 
(which admittedly, we have 
mixed feelings about). The basic 
course is free, and you can pay 
for a DataCamp subscription to 
access a wide range of advanced 


courses. A subscription isn’t 
cheap though, coming in at 
over $568 per year, although 
there are frequent half-price 
sales and it is aimed at budding 
data scientists. El 


Data sources 



DATA 

The US and UK governments have made 
huge datasets open. Everything from 
business figures to the environment, through 
mapping and spending, can be found online. 
data.gov.uk 


KAGGLE 

Kaggle is an online community owned by 
Google. It’s a great resource for datasets, 
as well as featuring blogs, competitions, 
and tools. 

kaggle.com/datasets 



DATAqUEST 

There’s a range of datasets around, from 
Google, Wikipedia, and Amazon, and even 
news outlets like BuzzFeed. Dataquest has a 
great list of sources for you to bookmark, 
magpi.cc/freedatasets 
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I 


Coursera 


l 


Duke University 
& John Hopkins 
University 


Price: 

£38 / $49 (per month) 

coursera.org 



Coursera offers a range of 
courses from universities. 

There are two that should 
be of interest. The first is 
Introduction to Probability 
and Data from Duke University 
(magpi.cc/courseraprobability), 
with a 4.7 star rating. Led 
by Mine (Jetinkaya-Rundel, 
Associate Professor of the 
Practice Department of 
Statistical Science, the course 
features R, but it’s more about 
learning to crank data. It gives 


you a grounding in probability 
and Bayes’ rule. It covers 
sampling methods, and forms 
part of a larger Statistics with 
R Specialization, which you can 
take to learn more about R. 

The second suggested 
course is R Programming from 
John Hopkins University 
(magpi.cc/courserar). This will 
get you closer to the R language 

After a seven-day free trial, 
you’ll pay Coursera a monthly 
fee to access the courses. ED 


( Introduction to R 
for Data Science 


Microsoft 


Price: FREE ($99 certificate) 

magpi.cc/edxr 


We’re big fans of the edX 
platform, which offers a range 
of courses from respected 
universities and organisations. 




Mmhiritofi iq nip OMC'Scferot 

ti 




Atoui ihb cornu 



WTUC you'll iMIl 




Its Introduction to R for Data 
Science course is provided by 
Microsoft, and runs on the 
DataCamp platform (so it’s 
an interactive web approach). 
This is interspersed with 
video tutorials and short 
online quizzes. And the edX 
community is vibrant, with an 
active forum that is ready to 
answer any questions you 
might have. 

It’s an accessible course and, 
thanks to being on edX, you can 
enrol and take the course for 
free. You only need to pay to get 
a certificate at the end. ED 


R websites 


I Bookmark these 
webpages while 
learning R 



R-BLOGGERS 

R-bloggers is a website 
aggregator for blogs on R. 

In it, you’ll find the latest 
contributions from hundreds of 
different R bloggers, 
r-bloggers.com 

R-EXERCISES 

R-exercises aims to help 
people develop and improve 
their R programming skills. 
R-exercises was initiated and 
is maintained by Research for 
Decisions, a Dutch research/ 
consulting firm, 
r-exercises.com 


REVOLUTIONS 

Revolutions is a blog 
dedicated to news for the 
R community. It’s a great 
place to find out recent 
developments and news. 
blog.revolutionanalytics.com 
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Andrew Suttle 

A young student who makes Raspberry Pi-powered 
robots at a university club 


> Day job Student I > Community role Club attendee and promoter 



T While some go there to 
build physical projects, 
others learn to code 


lthough Andrew is 
currently in year nine, 
that hasn’t stopped him 
from participating in what was 
once the very grown-up activity 
of building robots. 

“My first Raspberry Jam was 
Camjam in autumn 2013, when I 
showed some programs I had 
written,” Andrew tells us. “I also 
enjoy developing robots and 
doing electronics. I first went to 
the Colchester club run by John 
Woods in 2016, when I built a 
robot car using a Raspberry Pi. 
The Colchester club is run at the 


university and I like going there 
very much. The lab we use has all 
new oscilloscopes and I used 
them recently with some op-amp 
circuits. I also built my own 
oscilloscope from a kit and John 
Woods helped me get it working, 
as I had not soldered one of the 
connections properly. I took my 
oscilloscope into school and used 
it there.” 

Andrew isn’t the only young 
person at the club, either: 
“Several other children from my 
school have also gone to the club 
and I have built projects with 


them. We made an ( I y Pi’ team 
and entered competitions. We 
also had a ( Pi Rates’ team. My 
brother also goes to the club. He 
is building a security project with 
Arduino, and I might use some of 
his ideas in a programming 
course I am making. ” 

What kind of people attend? 

At the moment, it is all children 
aged 8 to 14 who come along 
with their parents, but we don’t 
have set age limits. The 
youngest children usually want 
to learn Python; the older 
children usually have a project 
of their own that they want to 
work on. People often drop in 
for a few sessions and solve a 
particular problem and then 
stop attending. We have had 



▲ Dr John Woods is a senior 
lecturer at the University of 
Essex, and also the runs the club 
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some stay for years and they are 
all from different local schools. 

One boy, Taylor, came 
regularly until he was 18. He 
developed several AI projects. 
He got a scholarship to 
Cambridge University, and 
graduates this year. 

Other members have entered 
competitions and we have had 
members win in the ‘BigBang’, 
Pioneers’, and ‘EasternDigital’ 
competitions. EasternDigital is 
an ‘adult’ competition for 
companies and one of the 
winners three years ago was ten 
years old; he was too young for 
their children’s competition! 

What projects have you or other 
people made there? 

As well as the AI projects I have 
mentioned, we have had 
members developing robotic 
arms. Then there was a flight 
control system for model 
aircraft and several robot cars. 


□ Some children are doing their own 
Python projects, with Python always 
a popular language □ 


Several children have 
gravitated towards embedded 
systems. Two children, Zara and 
Andrew, developed a plant 
monitoring system. 

What are you working on at 
the moment? 

Some of the younger children 
who are new to the club are 
doing directed tasks. Samuel, 
aged eight, and Xingtong, aged 
eleven, are both working on 
TicTacToe. But we do very 
little teaching. 

Some children are doing their 
own Python projects, with 
Python always a popular 
language. Robyn, aged twelve, 
has made a Mastermind-style 


game linked with Hangman. 
Andrew, now aged 14, has 
developed a version of Conway’s 
game of life. 

There are also several Arduino 
projects on the go. Victor, aged 
eleven, has just finished his 
security control system which is 
based on an Arduino Uno and 
written in C. 

There are always robots. We 
have a robot arena that is 
purpose-built for the 
development of robots, and we 
have a lot of knowledge and 
resources to support a robot 
project. The arena is 100 square 
metres in area, and has a six- 
metre-high ceiling to 
accommodate flying robots. EH 


Colchester 
Coding and 
Robotics Club 


“The club is Located at 
Essex University and 
uses a Lab run by the 
Computer Science 
and ELectronic 
Engineering (CSEE) 
school Getting to the 
university is easiest by 
car, with parking free 
on Sunday. The cLub is 
usuaLLy in the second- 
floor Lab in buiLding 
L77-1NW, which is 
Located immediateLy 
opposite the STEM 
centre in Square 1. We 
meet most Sundays 
during university 
term time." 
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This Month in 

Raspberry Pi 


MagPi Monday 


Amazing projects direct from our Twitter 

E very Monday we ask the question: have you 
made something with a Raspberry Pi over 
the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 
they’ve made. Here is a small fraction of them. 

Follow along at the hashtag #MagPiMonday. E 3 


Lorraine Underwood 

©LMtUnderwood 


Rpplytrvff to @1 heMaqPi 


01 


I 3d mapped the Christmas tree lights! 

tw i tte r.c o m/ LM c U nd e rwo od/s.„ 

Blog post here: jorraine.meunderwood.org/christmas- 
tree/ 


01 . 3D mapping is some dark magic, but 
Lorraine has managed to pull it off for 
her incredible animated tree Lights 

02. Amazing work from a near ten-year-old, 
and a great example of fun and simple 
Raspberry Pi projects 

03. People don’t mess about with Pi Wars, 
especially when materials can mean a 
win or Loss 

04. This is a very cool and simplistic info 
cube that we kinda want 

05. Who could the mysterious beastie be? 

06. This is a cool, abstract project that 
makes great use of the Twitter API 

07. We Love a tiny retro console, and this 
Raspberry Pi Zero-sized one is Lovely 

08 . Razvan sent us a Load of great projects 
with very practical uses 

09. Another month, another excellent- 
looking Pip-Boy build 
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a Brfan Cortdl ^ 

#CimanFoddkf 


02 


«rtXVOtKH 

S LHhCrt vbrts 
R»0^tO*ThtMt4H 

I've beer making pans for my prarars robot. specifically 
material study to see if I can makt batteiy retaining 
dips that bend a little, in PLA, Slop post to come, 


03 



mnltl Bndy 

|f &&inT6r#dy 


I finished off ilie code for this info display at home. 
Shows the time, buses due, and max temp. I'll also be 
adding precipitation and bin day reminders soon. 


(.durante Molloy 

^rvcHoyLaureiKt 

ftetHyinj (oetTieMagPf 

#M ag Pi Monday 

We have a night time intrude in our house. It ripped a 
food pouch to shreds & sent our cat mental the other 
night 

I set something up ready to catch our night time 
intruder in the act. HI set it in front of our cat flap 
(which it broke in a previous forced entry) 


• HMpbenyPlnl 

ttt^ssbefryPinl RlH 

Rr|:Jyii>3 IQ ^-hif.I.HqKi HHH 

I have modified one of my projects to be more 
Christmas/, It connects to Twitter and sets each of 180 
neopixels to a colour representing someone it follows. 
Each pixel represents a tweet or retweet. It constantly 
changes as tweets arrive. I presented at last meetup. 
6MagP Monday 


Replying Eg ©TheMag^i 

Tom {10 very soon) soldered up his (DThePiHut 
Christmas Tree by ©Rachel Ray ns and setup the 
Raspberry with no help from me 


Made using a Raspberry PI Zero and a CSpimoroni 
Ubercom LED matrix. 


#MagPi Monday 


Finished one of my ^inyretroporta bles. Has a S&Omah 
battery, li-icm charging, 3w mono amp & the tiniest 
5mm diameter speaker I could find! And the whole 
thing is only ~ Itm thick 




Replying Eg The Mag Pi 


Made a ftaspberri Py remote Control for a fellow 
Psychologist. Simple Rx/Tx IR LED connected to three 
pins, URC working Doubles as a Webserver he can 
access through OpenVPW to start/stop his heating via 
two Wireless S20 Sonoff smart plugs l‘ve installed Linux 
on. 


Justin Hart 

@jshart 


Almost finished the pipboy, all systems working, just a 
bit more python and paint to go! #MagPi Monday 
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Raspberry Pi« 
turns eight in 2020! 


Celebrate your favourite microcomputer on 29 February 2020 at a Raspberry Jam near you 


2 020 is one of those rare years: a leap year. 
February, the greatest month, receives an 
additional day, which just so happens to be 
the true birth-date of Raspberry Pi: 29 February 

It also lands on a Saturday, which makes it perfect 
for the return of the Birthday Jams! Here's a special 
message from Philip Colligan, CEO of the Raspberry 
Pi Foundation, on how you can get involved. 


Celebrate at a Raspberry Jam 

Raspberry Jams are community-led meet-ups 
that bring people together to share, connect, and 



learn from each other. The first one was held in 
Manchester in 2012, and so far Jams have been held 
in more than 70 countries - and that’s just the 
ones we know about. 

While Jams take place throughout the year, 
there’s a special tradition of Jams celebrating the 
birthday of the Raspberry Pi computer. This year, 
there were over 130 Raspberry Jam events in 39 
countries, attended by 8000 people! 

Register your Birthday Jam and 
we'll send you some special swag 

Next year, because it’s a big birthday, we’ll be 
sending a special box of swag to any Jam that is 
taking place between Saturday 15 February and 
Sunday 15 March 2020. 

It’s really simple to register your Birthday Jam: 
just fill in the Raspberry Jam submission form 
(magpi.cc/jamform), including a valid event 
information URL linking to a webpage with more 
information about your event. 

We’d prefer you to link to a public ticketing 
system (e.g. Eventbrite) if possible, but we know 
some libraries and community centres have 
restrictions that prevent them from doing this. 

In order to ensure that your pack reaches you in 
time, we need you to register your Birthday Jam at 
least six weeks before your event. 

As always, if you have any questions, please 
don’t hesitate to ask us: jam@raspberrypi.org. EH 
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Crowdfund this! 


Raspberry Pi projects you 
can crowdfund this month 




Tablet Frame Kit 


This kit is quite neat - it's part of an effort to create a 
Low-cost computing solution that uses a Raspberry Pi for 
schools and classrooms. It can even fit a breadboard on 
the back of it. It’s also able to act as a stand for several 
other Low-cost tablets, such as Amazon Fire. 

► kck.st/20gRvkF 


Vigibot, the ultimate web remote controller! 




Hake your own robot, learn and have fun! 


Vigibot 


Vigibot is a web-based control scheme for Raspberry 
Pi-powered robots. It has some pretty great functionality 
for all kinds of movement and actions, and includes a 
nice display that can show a Live view from a Raspberry 
Pi camera - with an optional pan-and-tilt mechanism. 

► kck.st/2QuEvt3 




Sound up your 
Raspberry Pi 


.com 
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Raspberry Jam 

Event Calendar 

Find out what community-organised Raspberry 
Pi-themed events are happening near you,,, 


01. Raspberry Jam Taiwan 

H Monday 30 December 

$ 2F, No.105, Sec. 1, Chongqing S. Rd, Taipei City, Taiwan 

► magpi.cc/yXigDK 

This Raspberry Jam will be focusing on uses of the 
Compute Module in solar power and more. 

02. Castro Valley Jam 

n Saturday 4 January 

<S> Castro Valley Library, Castro Valley, CA, USA 

► magpi.cc/7nrwp2 

If you’re interested in computer coding, you can tinker and 
code electronics at the Castro Valley Jam. 



05. South Devon Tech Jam 

n Saturday 11 January 

$ Paignton Library and Information Centre, Paignton, UK 

► magpi.cc/9vhGQ5 

A monthly informal and friendly session for anyone 
interested in technology, regardless of age or abiLity. 

06. WHPL Raspberry Jam 

n Monday 13 January 

9 Public Library, West Hempstead, NY, USA 

► whplibrary.org 

Learn to code in this Raspberry Jam using the library's 
brand new Raspberry Pi computers. 


FULL CALENDAR 

Get a full List of upcoming 
events for January and 
beyond here: 

rpf.io/jam 


03. Exeter Raspberry Jam 

n Saturday 4 January 
$ Exeter Library, Exeter, UK 

► magpi.cc/TYD 06 

A meeting for everyone interested in all things computers, 
microcontrollers, robotics, and making. 

04. Cornwall Tech Jam 

H Saturday 11 January 

$ Cornwall College Camborne, Camborne, UK 

► cornwalltechjam.uk 

For anyone interested in technology, of all ages and 
abilities. Ask questions and learn about programming. 


07. Raspberry Jam Zelzate 

n Saturday 25 January 

® Openbare Bibliotheek Zelzate, Zelzate, Belgium 

► magpi.cc/eUWnsH 

Everyone is welcome to start, share, and work on their own 
projects in a fun and relaxed atmosphere. 

08. Topsham Raspberry Jam 

□ Saturday 25 January 
$ Nancy Potter House, Exeter, UK 

► magpi.cc/ysRxpX 

A Code Club turned Jam. You’ll need to call the number at 
the League of Friends website to enrol. 
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FIND OUT 
ABOUT JAMS 

Want a Raspberry Jam 
in your area? Want to 
start one? 

jam@raspberrypi.org 


We've highlighted some of the areas 

i 

in need of a Jam! Can you help out? 


Raspberry Jam advice: 

Volunteers 


ur volunteers have badges that say ‘Jam 
Maker’ on them. Sometimes we have 
lanyards. Tim and I tend to wear 
our purple Camjam polo shirts. They weren’t 
cheap, but we do stand out!” 


Michael Horne - Cambridge Raspberry Jam 


Every Raspberry Jam is entitled to apply for a 
Jam starter kit, which includes magazine issues, 
printed worksheets, stickers, flyers, and more. 
Get the book here: rpf.io/guidebook 


- T , 


15 




RASPBERRY 


buiceooo 
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Your 

Letters 



Case necessity? 



▲ The official case is very 
sleek and stylish, and 
we really like the new 
black version! 


Are cases for Raspberry Pi truly 
necessary? I understand they 
don’t really come with one and 
have seen many people use one 
outside of a case. 

Frankie via Twitter 

For the longest time with our 
very first Raspberry Pi, we didn’t 
use a case with it. Even now, if 
we’re putting together a quick 
thing for the magazine, we’ll 
just have a Raspberry Pi sitting 
loose on a (wooden) table. So 
it’s not 100% necessary, but we 
always recommend getting a 
decent case - especially if your 
Raspberry Pi might sit in one 
place for a long time and feasibly 
get dusty. 


Contact us! 


> Twitter 

> Facebook 

> Email 

> Online 


@TheMagPi 

magpi.cc/facebook 

magpi@raspberrypi.org 

raspberrypi.org/forums 





the pages of The MagPi 


New user 


I’m getting my first Raspberry Pi for Christmas and am really 
excited by the possibilities. The only problem is that I feel a bit 
paralysed by choice! What should I do with my Raspberry Pi? 
Should I do many things? Will I need more? I hope you can help 
with these questions. 


Eddy via email 

It can be difficult to choose what to do with a Raspberry Pi once you 
have one! We’ve all been there ourselves. In this issue we have a few 
articles you might consider reading to get some ideas - first, there’s 
the 50 tools and tips feature (page 26). Here you can learn about any 
extra gear you need to start your maker journey, and maybe spark 
some ideas of what kind of project you want to make. Then we have 
the accessories and add-ons feature (page 68), which can give you 
advice on stuff to get for your Raspberry Pi, and the advanced kits and 
projects list (page 80) might give you some ideas as well. 

If all else fails, check out our latest Official Raspberry Pi 
Projects Book , Volume 5, for amazing ideas to help inspire you: 
magpi.cc/projects-book5 
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SD card requirements 


Whenever I see a sale for 
microSD cards online, I always 
feel like I should stock up on 
some for Raspberry Pi projects. 
Are there any limitations on 
size and speed and type of 
card, though? I’ve had issues 
in the past with cards getting 
corrupted in cameras and such, 
so want to make sure I don’t get 
any bad ones! 


Lou via email 

Most microSD cards will work 
fine with a Raspberry Pi. 
However, we usually advise to 
get 8GB or 16GB cards, and no 
smaller unless you know what 
you’re doing. Higher-capacity 
cards aren’t always necessary, 
and we find that the larger you 
go, the less likely they are to 
work with Raspberry Pi. For a 
list of tested cards, take a look 
at magpi.cc/sdcards 
In our experience, though, 
you’re better off getting 
a 16GB card and a big USB 
storage device. 



▲ It's best to check if a particular microSD 
card works with Raspberry Pi before 
buying it 



I’ve read a lot of stuff over the years about emulating old systems 
on Raspberry Pi, and using it as a streaming box for your gaming 
PC. However, I was wondering if there were any games that were 
released for Raspberry Pi natively? 


▲ Super Crate Box is a great game 
from the creators of Luftrausers 


Raspberry Pi games 


Lee via Facebook 


It’s not a popular computer to release games on. There have been 
a few made for it, though. Most notably, a few indie games made 
in GameMaker: Studio were released on Raspberry Pi back in 2016 
(you can read more here: magpi.cc/gamemaker), and Doom runs on 
Raspberry Pi if you can find the right files for it. 

As well as GameMaker, Tilengine (tilengine.org) allows for games 
to be developed for Raspberry Pi, so if you fancy making anything 
yourself, check them out! 

□ A few indie games were released on 
Raspberry Pi back in 2016 □ 
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RASPBERRY PI 4 

& CASE BUNDLES 



Still after a Raspberry 
Pi 4? We have five to 
give away, complete 
with one of the stylish 
official black and grey 
cases as well. 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/raspberrypi4 


Terms & Conditions 

Competition opens on 18 December 2019 and closes on 30 January 2020. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don’t like spam: participants’ details 
will remain strictly confidential and won’t be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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To a new era 

Rob Zwetsloot looks back at the decade of Raspberry Pi and The MagPi 


I remember sitting in my home 
at the start of the decade and 
feeling proud of myself. I’d 

cobbled together a media PC from 
a load of spare parts and cheap 
components from eBay, running the 
XBMC-based Boxee. A big old tower 
sitting next to a TV with a wireless 
keyboard and (ball) mouse for control. 
This was the future. It couldn’t 
get better than this, even if it was 
over S-Video. 


school education, bringing free 
computing resources to everywhere 
in the world, and being part of a new 
wave of makers. 

Eight years of Raspberry Pi 

It’s amazing to hear about the untold 
millions of Raspberry Pi computers 
sold over the last eight years, and 
even better seeing young folks enter 
the workforce who grew up with 
a Raspberry Pi. Yet still there are 


□ It's funny how much can change in ten years 
- or in this case, about three □ 


It’s funny how much can change 
in ten years - or in this case, about 
three, when a computer even cheaper 
and far smaller than my media PC 
came out: the humble Raspberry 
Pi Model B. I soon replaced the old 
machine with a Raspberry Pi with 
XBMC (now Kodi) installed and only 
recently upgraded it when Raspberry 
Pi 4 was released earlier this year. 

At the time I was amazed at how 
much Raspberry Pi could do. Little 
did any of us know just what it could 
achieve in the 2010s. A revolution 
in home robotics, helping overhaul 


new, young makers popping up with 
incredible Raspberry Pi projects. 

Working on The MagPi for the 
last four years has been a dream as 
well. Helping to highlight amazing 
projects, amazing events, and 
amazing people throughout the 
community and across the globe, and 
there’s no sign of that slowing down 
any time soon. 

I have many personal highlights 
from the last 50+ issues I’ve worked 
on, but I always come back to one: 
writing the main feature that went 
along with issue 40 - the Raspberry 


Pi Zero launch issue. We were all 
blown away by the response to its 
release, and I’m very proud that we 
were the first magazine to have a 
free computer on the cover. I still 
get emails asking if we have any left 
(not for several years, unfortunately), 
and Raspberry Pi Zero still amazes 
everyone I introduce it to. 

Welcome to tomorrow! 

Heading into 2020, I’m even more 
excited about the future of Raspberry 
Pi, making, and everything related to 
it. What incredible new projects will 
become trivial builds by 2030? How 
many more young people and kids 
will be enamoured with Raspberry 
Pi? Will Raspberry Pi go deeper into 
space? And will my media PC get 
smaller and better still? 

Whatever happens, I’ll be here 
to share and celebrate all that the 
community does with Raspberry Pi. 
Let’s make the next decade amazing. EH 


L 


Rob Zwetsloot 


Rob is amazing. He's also the Features 
Editor of The MagPi, a hobbyist maker, 
cosplayer, comic book writer, and 
extremely modest. 

magpi.cc 
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UniPiCase 

for Raspberry Pi 4 


Perfect option for your DIY or high-volume commercial projects 





Fits all kinds ofHATs 

Ideal PoE HAT case 

Use with HAT or Pi alone 

Simple and professional 

Rapid, tool-free assembly 

GPIO cable pass-through 

Two wall mount options 

Well ventilated 


www.UniPiCase.com 

L A 





Designed and manufactured in North America 










